使用说明

项目简介

MCP Riot Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它通过集成 Riot Games API，为 AI 助手提供查询英雄联盟游戏数据的能力。用户可以通过自然语言指令，让 AI 助手调用此服务器提供的工具，获取玩家的召唤师信息、排位数据、英雄熟练度、以及最近的比赛记录等。

主要功能点

玩家信息查询: 获取玩家的等级、排位段位、常用英雄以及最近比赛记录等综合信息。
英雄熟练度查询: 查询玩家在特定英雄上的熟练度信息，包括熟练度等级和点数。
最近比赛查询: 获取玩家最近的比赛历史，包含对局 ID、使用英雄、战绩等简要信息。
比赛概要查询: 查询指定比赛 ID 的详细数据，包括玩家在该场比赛中的各项统计信息。

安装步骤

克隆仓库

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

安装依赖 推荐使用 'uv' 进行依赖管理，如果未安装请先安装 'uv'。

uv sync

或者使用 'pip'：

pip install -r requirements.txt

配置 Riot API 密钥 访问 Riot Games 开发者网站申请 Riot API 密钥。在项目根目录下创建 '.env' 文件，并将密钥填入：
```
RIOT_API_KEY=YOUR_RIOT_API_KEY
```
请将 'YOUR_RIOT_API_KEY' 替换为您申请到的实际密钥。

服务器配置

要将 MCP Riot Server 集成到 MCP 客户端（例如 Claude for Desktop），您需要配置客户端的 MCP 服务器设置。以下是一个配置示例，请根据您的实际项目路径进行调整。

在 MCP 客户端的配置文件中（例如 Claude for Desktop 的 'claude_desktop_config.json'），添加如下 'mcpServers' 配置：

{
    "mcpServers": {
        "riot": {  // "riot" 为服务器名称，您可以自定义
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",  //  请替换为您的 uv 或 python 可执行文件的绝对路径
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/", // 请替换为您的项目 src 目录的绝对路径
                "run",
                "--env-file",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env", // 请替换为您的 .env 文件的绝对路径
                "server.py"
            ]
        }
    }
}

配置参数说明：

'serverName': 服务器名称，客户端用此名称标识和调用，可以自定义，例如 "riot"。
'command': 启动服务器的命令。这里示例中使用 'uv run' 运行 'server.py'，您需要根据您的环境，将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv' 替换为 'uv' 或 'python' 可执行文件的实际绝对路径。
'args': 传递给 'command' 的参数列表。
- '--directory': 指定服务器程序的工作目录，设置为项目 'src' 目录的绝对路径。
- 'run': 'uv run' 或 'python' 命令的子命令，用于运行 Python 脚本。
- '--env-file': 指定环境变量文件路径，指向包含 Riot API 密钥的 '.env' 文件。
- 'server.py': MCP 服务器的主程序文件名。

注意: 请务必将配置中的 '/ABSOLUTE/PATH/TO/PARENT/FOLDER' 替换为 MCP Riot Server 项目的实际绝对路径。

基本使用方法

完成服务器配置后，在 MCP 客户端中，即可通过自然语言指令调用 MCP Riot Server 提供的工具来查询英雄联盟游戏数据。例如，您可以向 AI 助手提问：

"查询玩家 'Hide on bush' 的当前段位和常用英雄"
"我想知道 'Faker' 最擅长哪些英雄"
"查询一下 'Uzi' 最近三场比赛的战绩"
"总结一下比赛 ID 为 'KR_6789012345' 的比赛数据"

AI 助手会将这些自然语言指令转换为对 MCP Riot Server 工具的调用，并返回相应的英雄联盟游戏数据。

关键词