AI导哈

VALORANT电竞数据服务

一个提供VALORANT电竞数据的Model Context Protocol (MCP)服务器，支持查询比赛、战队、选手统计等信息，并可与Claude Desktop集成。

  • by OkeahDavid
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 OkeahDavid/vlr-stats-mcp

使用说明

VLR统计MCP

一个模型上下文协议（MCP）服务器，为克劳德提供对VLR.gg VALORANT电子竞技数据的访问。内置FastMCP，便于与Claude Desktop集成。

样品响应

Player Profile: aspas
Timespan: ALL
Current Team: MIBR
Team Page: https://www.vlr.gg/team/7386/mibr
Profile: https://www.vlr.gg/player/8480/aspas

--- Agent Statistics (ALL) ---

1. Jett - (226) 51%
   Rating: 1.26 | ACS: 249.8 | K:D: 1.45
   Rounds: 4749 | ADR: 158.8 | KAST: 75%
   KPR: 0.91 | APR: 0.15 | FK/FD: 0.19/0.11
   Kills: 4303 | Deaths: 2977

2. Raze - (112) 26%
   Rating: 1.19 | ACS: 247.0 | K:D: 1.25
   Rounds: 2332 | ADR: 164.2 | KAST: 76%
   KPR: 0.87 | APR: 0.20 | FK/FD: 0.16/0.11
   Kills: 2018 | Deaths: 1614

特性

此MCP服务器提供以下工具来访问VALORANT电子竞技数据：

比赛：

  • get_upcoming_matchs -获取即将到来的VALORANT比赛，包括球队名称、赛事和时间
  • get_live_matches -使用实时地图得分获取当前直播的比赛
  • 获取匹配结果 -查看最近的比赛结果，包括比分和事件
  • 获取详细信息 -单场比赛的全部细节：地图否决权、每张地图得分和每位球员的记分牌（经纪人、ACS、K/D/a、ADR）

团队：

  • get_team_rankings -访问当前球队排名（按地区排名前20）
  • 搜索团队 -查找团队的个人资料：标签、活动名单和员工
  • get_team_matches -获取特定球队最近或即将举行的比赛
  • get_head_to_head -两个团队之间的直接W-L记录和过去的会议

活动：

  • get_events -浏览正在进行、即将举行和已完成的VALORANT锦标赛
  • get_event_details -单个活动的奖池、日期、地点和参赛队伍

球员和统计数据：

  • get_player_stats -通过代理统计和性能指标获取详细的玩家资料（支持时间过滤：30d、60d、90d，全部）
  • get_stats_leaderboard -按评级/ACS/K:D划分的地区和时间窗口（30d/60d/90d）的顶级玩家，有分页
  • get_agent_stats -每个事件的代理选择率和每个地图的攻击/防御获胜率

新闻：

  • 获取新闻 -最近的VALORANT电子竞技文章（标题、简介、日期、作者）

快速开始

安装

  1. 克隆此存储库：
git clone <your-repo-url>
cd vlr-stats-mcp
  1. 使用uv安装依赖项：
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

没有紫外线？安装它： pip install uv

  1. 测试服务器：
python src/vlr_mcp.py

Claude桌面集成

将MCP服务器添加到您的Claude Desktop配置中：

配置文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

快速配置示例：

{
  "mcpServers": {
    "vlr-stats": {
      "command": "python",
      "args": ["/absolute/path/to/vlr-stats-mcp/src/vlr_mcp.py"]
    }
  }
}

有关包括WSL、Windows和macOS配置在内的详细设置说明，请参阅 设置.md

添加配置后，完全重新启动Claude Desktop，VLR统计工具将可用！

示例用法

一旦整合，你可以问克劳德：

一般查询：

  • “现在有哪些有价值的比赛正在进行？”
  • “即将到来的有价值的比赛是什么？”
  • “显示最近的比赛结果”
  • “打破G2 vs Xi赖游戏比赛地图一张接一张”
  • “目前的球队排名是多少？”
  • “现在发生了什么有价值的事件？”
  • “谁将参加2026年电子竞技世界杯，奖池是多少？”

团队特定查询：

  • “G2 Esports最近5场比赛是什么？”
  • “Paper Rex下一场比赛是什么时候？”
  • “哨兵队名单上有谁？”
  • “哨兵和LOUD之间的正面交锋记录是什么？”

玩家和统计信息查询：

  • “在过去的90天里，阿斯巴斯最常用的药物是什么？”
  • “Demon1与哪个代理的K:D最好？”
  • “过去30天里，欧盟前10名球员是谁？”
  • “2026年电子竞技世界杯上，哪些经纪人被选中最多？”

新闻：

  • “最新的VALORANT名单消息是什么？”
  • “了解VLR最近的头条新闻”

工具参考

工具 说明
get_upcoming_matches(limit) 返回即将到来的VALORANT比赛
get_live_matches() 返回当前正在进行的比赛，以及地图得分
get_match_results(limit) 返回最近的比赛结果和分数
get_match_details(match, players_per_team) 返回比赛的否决权、每张地图得分和每位球员的记分牌
get_team_rankings(region) 按地区返回排名前20的球队
search_team(team_name) 返回团队的标签、名册和员工
get_team_matches(team_name, limit, match_type) 返回特定球队的比赛（结果/即将到来）
get_head_to_head(team1, team2, limit) 返回两个团队之间的W-L记录和过去的会议
get_events(status) 返回有价值的锦标赛和活动
get_event_details(event) 返回活动的奖品/日期/地点和参赛团队
get_player_stats(player_name, timespan) 返回带有详细代理统计信息的玩家档案（时间跨度：30d、60d、90d，全部）
get_stats_leaderboard(region, timespan, limit, min_rounds, page) 返回一个地区/窗口（30d/60d/90d）的玩家统计排行榜，分页
get_agent_stats(event, top) 每个事件的代理选择率和每个地图的ATK/DEF获胜率的回报
get_news(limit) 返回最近的VALORANT电子竞技新闻文章

玩家统计详细信息

这 get_player_stats 该工具提供全面的代理性能数据，包括：

  • 最常用的代理 -使用百分比选择主代理
  • 最佳K:D代理 -致死率最高的特工
  • 最高ACS代理 -平均战斗得分最高的特工
  • 每个代理的统计数据：评级、ACS、K:D、ADR、KAST、KPR、APR、FK/FD比率
  • 时间过滤：查看过去30/60/90天或所有时间的统计数据

测试

运行综合测试套件以验证所有工具：

python test_tools.py

这将测试：

  • MCP服务器初始化
  • 所有数据抓取工具
  • 连接到VLR.gg

项目结构

src/
  vlr_mcp.py           # Main MCP server (composes tool modules)
  config.py            # Shared config + fetch/cache/search helpers
  tools/
    matches.py         # get_upcoming_matches, get_live_matches, get_match_results, get_match_details
    teams.py           # get_team_rankings, search_team, get_team_matches, get_head_to_head
    players.py         # get_player_stats
    events.py          # get_events, get_event_details
    stats.py           # get_stats_leaderboard
    agents.py          # get_agent_stats
    news.py            # get_news
test_tools.py          # Comprehensive test suite

发展

内置：

  • FastMCP -简化的MCP服务器框架
  • httpx -异步HTTP客户端用于获取VLR.gg数据
  • 美丽的Soup4 -用于提取比赛和球队数据的HTML解析

贡献

欢迎投稿！请随时打开问题或提交pull请求。

许可证

看 许可证 文件以获取详细信息。

免责声明

这是一个非官方工具，与VLR.gg或Riot Games无关。请尊重VLR.gg的服务条款和费率限制。

相关 MCP