英雄联盟模型上下文协议（MCP）
  ](https://badge.fury.io/py/league-mcp) ](https://hub.docker.com/r/kostadindev/league-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：从源代码安装
- 克隆存储库：
git clone https://github.com/kostadindev/League-of-Legends-MCP.git
cd League-of-Legends-MCP- 安装依赖项（选择一种方法）：
选项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 每个目录中的虚拟环境。您不需要手动创建或激活它们！
- 在中设置环境变量
.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/ - 如何独立运行MCP服务器：
使用pip/python：
cd mcp-server
python main.py使用紫外线：
cd mcp-server
uv run main.py4.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密钥（用于客户端）
参考文献
🤝 贡献
我们欢迎捐款！请查看我们的 贡献指南 了解如何开始的详细信息。
- 分叉存储库
- 创建要素分支
- 进行更改
- 提交拉取请求
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
⚠️ 免责声明
该项目未得到Riot Games的认可，也不反映Riot Games或任何正式参与制作或管理Riot Games财产的人的观点或意见。Riot Games及所有相关财产均为Riot Game，股份有限公司的商标或注册商标。
📚 资源
______________________________________________________________________
由以下材料制成❤️ 为联盟社区