英雄联盟数据查询服务

MCP-Riot是一个社区开发的服务,通过整合Riot Games API,为AI助手提供英雄联盟玩家数据、排名统计、英雄熟练度和近期比赛摘要的自然语言查询功能。

  • by jifrozen0110
  • Python
  • 本地部署
  • 27 星标
  • 更新于
在 GitHub 查看 jifrozen0110/mcp-riot

使用说明

MCP防暴服务器

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

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

免责声明: 这是一个开源项目 与Riot Games无关或不受其认可。 英雄联盟®是Riot Games,股份有限公司的注册商标。


演示

✨ 特性

🧾 玩家摘要

“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 for Desktop)。

编辑~/库/应用支持/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的比赛表现统计数据。


📚 参考文献


📝 许可证

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