MCP Riot 服务器

MCP-Riot 是一个由社区开发的 模型上下文协议 (MCP) 服务器，它与 Riot Games API 集成，通过自然语言查询为 AI 助手提供英雄联盟数据。

该项目使 AI 模型能够检索玩家信息、排位统计数据、英雄熟练度和最近的比赛摘要。

免责声明： 这是一个开源项目，与 Riot Games 无关且未得到其认可。 英雄联盟® 是 Riot Games, Inc. 的注册商标。

演示

✨ 特性

🧾 玩家概要

"Hide on bush 当前的排名和顶级英雄是什么？"

提供玩家的：

• 等级
• 单排段位
• 顶级英雄熟练度
• 最近比赛历史

🔝 顶级英雄

"他最擅长哪些英雄？"

根据熟练度分数返回前 N 名英雄。

🎯 英雄熟练度

"这个玩家使用阿狸有多厉害？"

返回特定英雄的详细熟练度数据。

🕹️ 最近的比赛

"显示这位召唤师的最后 3 场比赛"

列出最近的比赛，包括使用的英雄、K/D/A 和结果。

📊 比赛摘要

"总结给定比赛 ID 的这场比赛"

返回玩家的比赛统计数据，如 KDA、伤害、眼位和结果。

🚀 快速开始

1. 克隆 & 安装

git clone https://github.com/jifrozen0110/mcp-riot.git
cd mcp-riot

# Install dependencies (using uv or pip)
uv sync

2. 获取您的 API 密钥并设置环境

创建包含您的 Riot API 密钥的 .env 文件：

RIOT_API_KEY=your_riot_api_key

您可以从 https://developer.riotgames.com/ 获取密钥

3. 配置 MCP 客户端

在您的 MCP 客户端（例如 Claude for Desktop）中注册此服务器。

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "amadeus": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
                "run",
                "--env-file",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
                "riot.py"
            ]
        }
    }
}

将 /ABSOLUTE/PATH/TO/PARENT/FOLDER/ 替换为您的项目文件夹的实际路径。

我的情况：

{
    "mcpServers": {
        "amadeus": {
            "command": "/Users/jifrozen/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/jifrozen/mcp-riot/src/",
                "run",
                "--env-file",
                "/Users/jifrozen/mcp-riot/.env",
                "server.py"
            ]
        }
    }
}

🛠️ 工具

以下工具将暴露给 MCP 客户端：

get_player_summary

总结等级、段位、顶级英雄和最近的比赛。

get_top_champions_tool

按熟练度分数返回顶级英雄。

get_champion_mastery_tool

返回特定英雄的熟练度详情。

get_recent_matches_tool

返回给定召唤师的最近比赛。

get_match_summary

返回给定比赛 ID 和 puuid 的比赛表现统计数据。

📚 参考资料

• 模型上下文协议 Python SDK
• Riot Games API 文档
• Data Dragon (静态数据)

📝 许可证

MIT 许可证 © 2025 jifrozen0110