AI导哈

英雄联盟模型上下文协议

一个为英雄联盟游戏提供Riot Games API接口、静态资源和流程提示的模型上下文协议服务器，包含一个基于ReAct代理的客户端聊天机器人UI。

  • by kostadindev
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 kostadindev/League-of-Legends-MCP

使用说明

英雄联盟模型上下文协议（MCP）

英雄联盟的模型上下文协议（MCP）服务器，公开所有Riot Games API、静态资源（冠军、物品、等级等）和工作流提示。包括一个带有聊天机器人UI的MCP客户端，以演示其使用ReAct代理进行工具/资源/提示调用的实用程序。您可以构建自己的客户端或使用Claude for Desktop。

MCP服务器功能

  • Riot Games API报道：账户，召唤师，比赛，联盟，观众，冠军，冲突，锦标赛，状态，挑战
  • 静态资源：冠军、物品、召唤法术、队列、地图、游戏模式、排名等级
  • 工作流程提示：玩家统计数据、冠军分析、团队比较、锦标赛、改进计划

MCP客户端功能（可选）

  • 重新代理
  • 聊天机器人用户界面
  • 工具调用
  • 资源利用率
  • 快速工作流

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

快速启动

选项1：使用Docker🐳 （推荐）

直接从Docker Hub拉取并运行：

# For stdio transport (Claude Desktop integration)
docker run -i -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest

# For SSE transport (web integrations)
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 // obtain for free from https://developer.riotgames.com/
    • 在……里面 mcp-client/.env （仅当您想试用客户端时）：
      GOOGLE_API_KEY=your_gemini_api_key // obtain for free from https://aistudio.google.com/

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

    使用pip/python：

    cd mcp-server
python main.py

    使用紫外线：

    cd mcp-server
uv run main.py

4.5.同时运行MCP客户端和MCP服务器（从项目根目录开始）：

使用pip/python：

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

使用紫外线：

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许可证获得许可-请参阅 许可证 文件以获取详细信息。

⚠️ 免责声明

该项目未得到Riot Games的认可，也不反映Riot Games或任何正式参与制作或管理Riot Games财产的人的观点或意见。Riot Games及所有相关财产均为Riot Game，股份有限公司的商标或注册商标。

📚 资源

由以下材料制成❤️ 为联盟社区

相关 MCP