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_team_rankings -访问当前球队排名（按地区排名前20）
- get_events -浏览正在进行、即将举行和已完成的VALORANT锦标赛
团队特定：
- get_team_matches -获取特定球队最近或即将举行的比赛
- 搜索团队 -搜索特定团队并获取他们的信息
玩家特定：
- get_player_stats -通过代理统计和性能指标获取详细的玩家资料（支持时间过滤：30d、60d、90d，全部）
快速开始
安装
- 克隆此存储库：
git clone
cd vlr-stats-mcp- 使用uv安装依赖项：
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .没有紫外线？安装它： pip install uv- 测试服务器：
python src/vlr_mcp.pyClaude桌面集成
将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 Esports最近5场比赛是什么？”
- “Paper Rex下一场比赛是什么时候？”
- “显示哨兵最近的比赛”
玩家特定查询：
- “在过去的90天里，阿斯巴斯最常用的药物是什么？”
- “显示TenZ所有时间的代理统计数据”
- “Demon1与哪个代理的K:D最好？”
- “Less在过去30天的统计数据是什么？”
- “向我展示Chronicle在所有代理商中的表现”
工具参考
| 工具 | 说明 |
|---|---|
get_upcoming_matches(limit) | 返回即将到来的VALORANT比赛 |
get_match_results(limit) | 返回最近的比赛结果和分数 |
get_team_rankings(region) | 按地区返回排名前20的球队 |
get_team_matches(team_name, limit, match_type) | 返回特定球队的比赛（最近/即将举行） |
search_team(team_name) | 搜索特定团队 |
get_events(status) | 返回有价值的锦标赛和活动 |
get_player_stats(player_name, timespan) | 返回带有详细代理统计信息的玩家档案（时间跨度：30d、60d、90d，全部） |
玩家统计详细信息
这 get_player_stats 该工具提供全面的代理性能数据，包括：
- 最常用的代理 -使用百分比选择主代理
- 最佳K:D代理 -致死率最高的特工
- 最高ACS代理 -平均战斗得分最高的特工
- 每个代理的统计数据：评级、ACS、K:D、ADR、KAST、KPR、APR、FK/FD比率
- 时间过滤：查看过去30/60/90天或所有时间的统计数据
测试
运行综合测试套件以验证所有工具：
python test_tools.py这将测试：
- MCP服务器初始化
- 所有7个数据抓取工具
- 连接到VLR.gg
项目结构
src/
vlr_mcp.py # Main MCP server (composes tool modules)
config.py # Shared configuration (base URL, headers, timeouts)
tools/
matches.py # get_upcoming_matches, get_match_results
teams.py # get_team_rankings, search_team, get_team_matches
players.py # get_player_stats
events.py # get_events
test_tools.py # Comprehensive test suite发展
内置：
- FastMCP -简化的MCP服务器框架
- httpx -异步HTTP客户端用于获取VLR.gg数据
- 美丽的Soup4 -用于提取比赛和球队数据的HTML解析
贡献
欢迎投稿！请随时打开问题或提交pull请求。
许可证
看 许可证 文件以获取详细信息。
免责声明
这是一个非官方工具，与VLR.gg或Riot Games无关。请尊重VLR.gg的服务条款和费率限制。