麦普暴动

Name: 麦普暴动
Author: jifrozen0110

作者：jifrozen011019 星标更新：2025-07-06

安装使用来源：spider==github.com

项目介绍

MCP Riot 服务器

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

该项目使 AI 模型能够检索玩家信息、排名统计、英雄熟练度以及最近的比赛摘要。

免责声明： 这是一个开源项目，未得到 Riot Games 的支持或认可。《英雄联盟》® 是 Riot Games, Inc. 的注册商标。

示例

mcp-riot-lol

✨ 特性

🧾 玩家概要

"隐藏在灌木丛中的当前排名和顶级英雄是什么？"

提供玩家的：

等级
排位单人赛段位
顶级英雄熟练度
最近的比赛历史

🔝 顶级英雄

"他最擅长哪些英雄？"

返回基于熟练度点数的顶级 N 名英雄。

🎯 英雄熟练度

"这个玩家使用艾希有多厉害？"

返回特定英雄的详细熟练度数据。

🕹️ 最近的比赛

"显示这个召唤师的最后三场比赛"

列出最近的比赛，包括使用的英雄、K/D/A 和比赛结果。

📊 比赛摘要

"根据给定的比赛ID总结这场比赛"

返回玩家的比赛统计数据，如KDA、伤害、守卫和比赛结果。

🚀 快速开始

1. 克隆并安装

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

# 安装依赖项（使用 uv 或 pip）
uv sync

2. 获取您的 API 密钥并设置环境

创建包含您的 Riot API 密钥的 .env 文件：

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的比赛表现统计数据。