Valorant电竞MCP服务器

Valorant电竞MCP服务器提供比赛日程、实时结果、提醒和AI分析功能,适用于Valorant电竞爱好者。

  • by ZenDeveloper7
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ZenDeveloper7/valorant-mcp

使用说明

英勇的mcp

Valorant电子竞技的MCP服务器——比赛日程、实时结果、提醒和人工智能分析。

任何与MCP兼容的AI代理(Claude、Cursor、Windsurf等)都可以安装这个,并立即提出以下问题 “现在有哪些比赛正在进行?”, “在哨兵队下一场比赛前提醒我”,或 “昨天的冠军决赛中谁是MVP?”

数据来源于 vlr.gg分析由Claude提供支持(可选)。


快速入门

# Run directly (no install)
npx valorant-mcp

# Or install globally
npm install -g valorant-mcp

添加到克劳德桌面/克劳德代码

// ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "valorant": {
      "command": "npx",
      "args": ["valorant-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}

ANTHROPIC_API_KEY 仅需要 get_match_analysis 和 get_match_preview没有它,所有其他工具都能工作。


工具

工具 说明
get_upcoming_matches 直播+接下来N小时内即将到来的比赛
get_recent_results 最新完成的比赛结果
get_match_details 一场比赛的逐图得分和球员统计数据
search_matches 按团队名称、活动或地区搜索
get_match_analysis AI驱动的细分:MVP、关键轮次、团队总结
get_match_preview 赛前炒作和背景
subscribe_reminder 为球队或特定比赛设置提醒
list_reminders 查看所有待处理的提醒
cancel_reminder 删除提醒

对话示例

“今天有什么瓦罗兰比赛?”

“在哨兵队下一场比赛前10分钟提醒我”

“谁赢得了2025年冠军决赛,比分是多少?”

“给我一份对Liquid队上一场比赛的全面分析”

“现在有哪些比赛正在进行?”


环境变量

变量 必填 描述
ANTHROPIC_API_KEY 用于分析工具 电源 get_match_analysis 和 get_match_preview
TELEGRAM_BOT_TOKEN 对于Pi守护进程 用于通知的Telegram机器人令牌
TELEGRAM_CHAT_ID 对于Pi守护进程 您的Telegram聊天ID
DISCORD_WEBHOOK_URL 可选 用于通知的Discord webhook

Pi Daemon(背景提醒)

MCP服务器处理来自AI代理的按需查询。对于 自动通知 无需打开代理,即可在Raspberry Pi或任何永远在线的设备上运行Python守护进程:

pip install requests

export TELEGRAM_BOT_TOKEN="your_token"
export TELEGRAM_CHAT_ID="your_chat_id"

python3 daemon/valorant_daemon.py

守护进程读取MCP服务器保存的提醒(subscribe_reminder 工具),并在比赛即将开始时发出通知。

开机自动启动

# Edit the service file with your credentials
nano daemon/valorant-daemon.service

sudo cp daemon/valorant-daemon.service /etc/systemd/system/
sudo systemctl enable --now valorant-daemon
sudo systemctl status valorant-daemon

从源代码构建

git clone https://github.com/YOUR_USERNAME/valorant-mcp
cd valorant-mcp
npm install
npm run build
npm start

# Test with the MCP Inspector UI
npm run inspector

建筑

src/
├── index.ts              # MCP server entry point (9 tools)
├── scraper/
│   ├── vlr.ts            # vlr.gg scraper
│   └── types.ts          # Shared TypeScript interfaces
├── tools/
│   ├── matches.ts        # Match listing and search tools
│   ├── analysis.ts       # AI analysis and preview tools
│   └── reminders.ts      # Reminder management tools
├── analysis/
│   ├── claude.ts         # Anthropic API client
│   └── prompts.ts        # Analysis and preview prompt templates
└── db/
    └── index.ts          # SQLite (reminders + response cache)

daemon/
├── valorant_daemon.py    # Python background worker for Pi
└── valorant-daemon.service  # systemd service file

运作原理

  1. 抓取 --比赛数据根据需要从vlr.gg中抓取。结果将缓存1小时。
  2. 提醒事项 --存储在本地SQLite数据库中(~/.valorant-mcp/data.db).Pi守护进程每60秒轮询一次,并发出到期提醒通知。
  3. 分析 --比赛统计数据被馈送给Claude,Claude返回结构化的自然语言分解。结果将被永久缓存(同一匹配不会重新计费)。

在哪里可以找到MCP服务器

正在寻找更多MCP服务器?检查这些目录:


许可证

麻省理工学院