Integrations

Communicates with the League of Legends Live Client Data API to retrieve in-game data, offering tools to access game statistics, events, player information, abilities, runes, items, and scores during active gameplay.

LoL客户端MCP

用于访问英雄联盟客户端数据的 MCP（模型-控制器-处理器）服务器。该服务器提供了一系列工具，可与英雄联盟实时客户端数据 API 通信，以检索游戏内数据。

概述

该项目使用英雄联盟游戏客户端的实时客户端数据 API 访问实时游戏数据。它利用 FastMCP 框架将各种端点公开为工具。

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

安装和使用

先决条件

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

运行 MCP 服务器

直接运行：

python main.py

与克劳德的整合

有两种方法可以与 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 应用程序：

运行 MCP 服务器：
python main.py
在 Claude 网页界面配置服务器连接：
- 开始对话时，前往底部的 MCP 设置
- 选择“lol-client-mcp”并连接

API 工具列表

游戏数据

get_all_game_data() ：Live 英雄联盟客户端数据 API 拥有多个端点，它们会返回 /allgamedata 端点所返回数据的子集。此端点非常适合测试 Live 客户端数据 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 所有。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested