STARWARCLOUD STARWAR.AI
返回市场
英雄联盟-mcp

英雄联盟-mcp

作者：kostadindev2 星标更新：2025-06-20
安装使用来源：spider==github.com

项目介绍

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

MIT 许可证 Python 3.9+ PyPI 版本 Docker Hub

这是一个为《英雄联盟》设计的模型上下文协议 (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 密钥（用于客户端）

参考资料

🤝 贡献

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

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

📄 许可证

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

⚠️ 免责声明

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

📚 资源

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