LoL Client MCP

这是一个用于访问《英雄联盟》客户端数据的MCP（模型-控制器-处理器）服务器。该服务器提供了一系列工具，通过与《英雄联盟》实时客户端数据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

2. 使用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所有。