MCP Riot Server

MCP Riot Server

site icon
2025.04.17 1
Python游戏数据英雄联盟娱乐功能
MCP-Riot 是一个社区开发的 Model Context Protocol (MCP) 服务器,集成了 Riot Games API,通过自然语言查询为 AI 助手提供《英雄联盟》游戏数据。该项目使 AI 模型能够获取玩家信息、排名统计、英雄熟练度和最近的比赛摘要。
View on GitHub

Overview

基本能力

产品定位

MCP-Riot 是一个为 AI 助手提供《英雄联盟》游戏数据的服务,通过自然语言查询获取玩家信息和比赛数据。

核心功能

  • 玩家摘要:提供玩家的等级、排名、顶级英雄熟练度和最近的比赛历史。
  • 顶级英雄:根据熟练度点数返回玩家的前 N 个英雄。
  • 英雄熟练度:返回特定英雄的详细熟练度数据。
  • 最近比赛:列出玩家最近的比赛,包括使用的英雄、K/D/A 和结果。
  • 比赛摘要:返回给定比赛 ID 的玩家比赛统计数据,如 KDA、伤害、视野和结果。

适用场景

  • AI 助手查询玩家游戏数据
  • 分析玩家游戏表现
  • 获取英雄熟练度和比赛历史

工具列表

  • get_player_summary:汇总玩家的等级、排名、顶级英雄和最近的比赛。
  • get_top_champions_tool:根据熟练度点数返回顶级英雄。
  • get_champion_mastery_tool:返回特定英雄的熟练度详情。
  • get_recent_matches_tool:返回给定召唤师的最近比赛。
  • get_match_summary:返回给定比赛 ID 和 puuid 的比赛表现统计数据。

常见问题解答

  • 如何获取 Riot API 密钥?:从 Riot Games 开发者网站 获取。
  • 如何配置 MCP 客户端?:编辑 claude_desktop_config.json 文件,指定服务器路径和参数。

使用教程

使用依赖

  1. 克隆仓库并安装依赖:
git clone https://github.com/jifrozen0110/mcp-riot.git
cd mcp-riot
uv sync

安装教程

  1. 创建 .env 文件并设置 Riot API 密钥:
RIOT_API_KEY=your_riot_api_key
  1. 配置 MCP 客户端: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件,指定服务器路径和参数。

调试方式

  1. 确保 .env 文件中的 API 密钥正确。
  2. 检查 MCP 客户端配置文件的路径是否正确。
  3. 运行服务器并测试工具功能。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。