星战科技xingzhan.cloud
返回市场
联赛-MCP

联赛-MCP

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

项目介绍

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

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

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

MCP服务器特性

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

MCP客户端特性（可选）

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

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

快速开始

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

从Docker Hub拉取并运行：

# 对于标准I/O传输（Claude桌面集成）
docker run -i -e RIOT_API_KEY=你的API密钥 kostadindev/league-mcp:latest

# 对于SSE传输（Web集成）
docker run -p 8000:8000 -e RIOT_API_KEY=你的API密钥 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 ..
    • 在m.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=你的Riot API密钥 // 可免费获取自 https://developer.riotgames.com/
    • 在mcp-client/.env中（仅当你想尝试客户端时）： 
      GOOGLE_API_KEY=你的Gemini API密钥 // 可免费获取自 https://aistudio.google.com/

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

    使用pip/python：

    cd mcp-server
python main.py

    使用uv：

    cd mcp-server
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.的商标或注册商标。

📚 资源

为英雄联盟社区制作 ❤️