MCP Riot Server

MCP Riot 服务端

MCP-Riot 是由社区开发的 Model Context Protocol (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 密钥并设置环境

创建 .env 文件并填入 Riot API 密钥：

RIOT_API_KEY=your_riot_api_key

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

3. 配置 MCP 客户端

在 MCP 客户端（例如 Claude 桌面版）中注册此服务。

编辑 ~/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 返回对局表现数据。

---

📚 参考资料

• Model Context Protocol Python SDK
• Riot Games API 文档
• Data Dragon（静态数据）

---

📝 许可证

MIT License © 2025 jifrozen0110