LoL 客户端 MCP

这是一个用于访问《英雄联盟》客户端数据的MCP（Model-Controller-Processor）服务器。该服务器提供了一系列工具，通过与《英雄联盟》实时客户端数据API通信来检索游戏中的数据。

概览

此项目使用《英雄联盟》游戏客户端的实时客户端数据API访问实时游戏数据。它利用FastMCP框架将各种端点作为工具暴露出来。

API信息可以在 https://developer.riotgames.com/docs/lol 查找。

安装和使用

前提条件

• Python 3.8 或更高版本
• uv - 快速可靠的Python包管理器
  • 安装: pip install uv
• 已安装《英雄联盟》客户端

项目设置

1. 克隆此仓库：

git clone https://github.com/yourusername/lol-client-mcp.git
cd lol-client-mcp

1. 使用uv安装所需包：

uv pip install httpx fastmcp

运行MCP服务器

直接运行：

python main.py

与Claude集成

有两种方式可以与Claude一起使用：

1. Claude桌面配置

在你的claude_desktop_config.json文件中添加以下内容：

{
    "mcpServers": {
        "lol-client-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

重要: 将C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp替换为你的项目的实际路径。

2. 与Web应用程序一起使用

要将MCP服务器连接到Claude Web应用程序：

1. 运行MCP服务器：

   python main.py
   

2. 在Claude Web界面中配置服务器连接：

   • 启动对话时转到底部的MCP设置
   • 选择'lol-client-mcp'并连接

API工具列表

游戏数据

• get_all_game_data(): 实时《英雄联盟》客户端数据API有许多端点返回由/allgamedata端点返回的数据子集。此端点非常适合测试实时客户端数据API，但除非你确实需要来自此端点的所有数据，否则请使用下面列出的返回响应子集的端点之一。
• 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): 检索玩家的物品列表。

故障排除

• 连接错误：请检查《英雄联盟》客户端是否正在运行。
• 超时错误：请确认游戏是否已经真正开始。此 API 在游戏大厅中不起作用。

注意事项

• 该 API 仅在《英雄联盟》客户端运行且正在进行游戏时有效。
• 使用时需遵守 Riot Games 的 API 政策。

许可

所有权利归 Riot Games 所有。