LoL Client MCP
2025.04.02
4
Python游戏数据服务娱乐功能
LoL Client MCP 是一个用于访问《英雄联盟》游戏客户端数据的 MCP（Model-Controller-Processor）服务器。该项目通过《英雄联盟》游戏客户端的 Live Client Data API 获取实时游戏数据，并利用 FastMCP 框架将各种端点作为工具暴露出来。主要功能包括获取游戏数据、活跃玩家数据、玩家列表及个体玩家数据等。适用于需要实时获取和分析《英雄联盟》游戏数据的场景。
View on GitHub
Overview
基本能力
产品定位
LoL Client MCP 是一个专门用于访问和获取《英雄联盟》游戏客户端实时数据的服务器。
核心功能
- 获取游戏数据：包括游戏状态、事件数据等。
- 获取活跃玩家数据：包括玩家名称、技能、符文等。
- 获取玩家列表及个体玩家数据：包括玩家分数、召唤师技能、主要符文、物品等。
适用场景
- 实时监控和分析《英雄联盟》游戏数据。
- 开发与《英雄联盟》游戏相关的辅助工具或分析平台。
工具列表
get_all_game_data(): 获取所有游戏数据。get_game_stats(): 获取游戏基本数据。get_event_data(): 获取游戏中发生的事件列表。get_active_player(): 获取活跃玩家的所有数据。get_active_player_name(): 获取活跃玩家名称。get_active_player_abilities(): 获取活跃玩家技能。get_active_player_runes(): 获取活跃玩家符文列表。get_player_list(): 获取游戏中的英雄列表及其状态。get_player_scores(riot_id): 获取玩家的当前分数。get_player_summoner_spells(riot_id): 获取玩家的召唤师技能。get_player_main_runes(riot_id): 获取玩家的基本符文。get_player_items(riot_id): 获取玩家的物品列表。
常见问题解答
- Connection Error: 检查《英雄联盟》客户端是否正在运行。
- Timeout Error: 确认游戏已经开始。此 API 在游戏大厅中无效。
使用教程
使用依赖
- Python 3.8 或更高版本。
- uv - 快速可靠的 Python 包管理器。
- 安装命令:
pip install uv - 已安装《英雄联盟》客户端。
安装教程
- 克隆仓库:
git clone https://github.com/yourusername/lol-client-mcp.git
cd lol-client-mcp
- 使用 uv 安装所需包:
uv pip install httpx fastmcp
调试方式
直接运行:
python main.py
与 Claude 集成:
1. 在 claude_desktop_config.json 文件中添加配置。
2. 或在 Claude 网页界面中配置服务器连接。