League of Legends 模型上下文协议 (MCP)

这是一个为《英雄联盟》设计的模型上下文协议 (MCP) 服务器，它暴露了所有的 Riot Games API、静态资源（如英雄、物品、等级等）以及工作流程提示。包括一个带有聊天机器人界面的 MCP 客户端，该客户端使用 ReAct 代理进行工具/资源/提示调用以展示其实用性。你可以构建自己的客户端或使用 Claude for Desktop。

MCP 服务器特性

• Riot Games API 覆盖：账户、召唤师、比赛、联赛、观战、英雄、冲突、锦标赛、状态、挑战
• 静态资源：英雄、物品、召唤师技能、队列、地图、游戏模式、排名等级
• 工作流程提示：玩家统计、英雄分析、团队组成、锦标赛、改进计划

MCP 客户端特性（可选）

• ReAct 代理
• 聊天机器人界面
• 工具调用
• 资源利用
• 提示工作流

https://github.com/user-attachments/assets/101ee6dc-af42-4bf0-81b0-3caba49c83a7

快速开始

方案 1：使用 Docker 🐳 （推荐）

从 Docker Hub 直接拉取并运行：

# 对于标准 I/O 传输（与 Claude Desktop 集成）
docker run -i -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest

# 对于 SSE 传输（与 Web 集成）
docker run -p 8000:8000 -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest league-mcp --transport sse

使用 Docker Compose：

version: '3.8'
services:
  league-mcp:
    image: kostadindev/league-mcp:latest
    environment:
      - RIOT_API_KEY=${RIOT_API_KEY}
    command: ["league-mcp", "--transport", "sse"]
    ports:
      - "8000:8000"
    restart: unless-stopped

方案 2：从 PyPI 安装

简单地使用 pip 安装 MCP 服务器：

pip install league-mcp

然后运行服务器：

league-mcp

方案 3：从源码安装

1. 克隆仓库：

   git clone https://github.com/kostadindev/League-of-Legends-MCP.git
   cd League-of-Legends-MCP
   

2. 安装依赖项（选择一种方法）：

   方案 A：使用 pip

   • 在 mcp-server/ 中：

     cd mcp-server
     pip install -r requirements.txt
     cd ..
     

   • 在 mcp-client/ 中：

     cd mcp-client
     pip install -r requirements.txt
     cd ..
     

   注意：使用 pip 时，你需要手动创建并激活虚拟环境。记得在运行应用程序之前激活相应的环境！

   方案 B：使用 uv（推荐用于更快的安装）

   • 如果尚未安装，请先安装 uv：

     pip install uv
     

   • 在 mcp-server/ 中：

     cd mcp-server
     uv sync
     cd ..
     

   • 在 mcp-client/ 中：

     cd mcp-client
     uv sync
     cd ..
     

   注意：uv 自动在每个目录中创建和管理 .venv 虚拟环境。你不需要手动创建或激活它们！

3. 在 .env 文件中设置环境变量：

   • 在 mcp-server/.env 中：

     RIOT_API_KEY=your_riot_api_key // 从 https://developer.riotgames.com/ 免费获取
     

   • 在 mcp-client/.env 中（仅当你想尝试客户端时）：

     GOOGLE_API_KEY=your_gemini_api_key // 从 https://aistudio.google.com/ 免费获取
     

4. 如何独立运行 MCP 服务器：

   使用 pip/python：

   cd mcp-server
   python main.py
   

   使用 uv：

   cd m_服务器
   uv run main.py
   

4.5. 一起运行 MCP 客户端和 MCP 服务器（从项目根目录）：

使用 pip/python：

python mcp-client/client.py mcp-server/main.py

使用 uv：

uv run mcp-client/client.py mcp-server/main.py

• 客户端启动了一个 Gradio Web UI。示例查询：
  • Sneaky#NA69 的当前排名是什么？
  • 显示我 ddragon://champions

项目结构

• mcp-server/ - MCP 服务器（所有 Riot API、资源、提示）
• mcp-client/ - LangChain ReAct 代理客户端（Gradio UI）

要求

• Python 3.9+
• Riot API 密钥（用于服务器）
• Google API 密钥（用于客户端）

参考资料

• Riot Games 开发者门户
• 模型上下文协议 (MCP)

🤝 贡献

我们欢迎贡献！请参阅我们的 贡献指南，了解如何开始。

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 提交拉取请求

📄 许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。

⚠️ 免责声明

本项目未经 Riot Games 认可，不代表 Riot Games 或任何正式参与 Riot Games 财产生产或管理的人的观点或意见。Riot Games 及其相关财产是 Riot Games, Inc. 的商标或注册商标。

📚 资源

• Riot Games API 文档
• 模型上下文协议规范

---

为《英雄联盟》社区制作 ❤️