MCP Riot 服务器

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

该项目使人工智能模型能够检索玩家信息、排名统计数据、冠军掌握情况和最近的比赛摘要。

**免责声明：*本项目为开源项目，与 Riot Games 并无关联，亦未获得其任何认可。*英雄联盟® 是 Riot Games, Inc. 的注册商标。

演示

Related MCP server: lol-client-mcp Public

✨ 特点

🧾 玩家概要

“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 游戏 API 文档

• 数据龙（静态数据）

📝 许可证

麻省理工学院许可证 © 2025 jifrozen0110