AI导哈

英雄联盟客户端数据访问工具

一个用于访问英雄联盟客户端实时游戏数据的MCP服务器，提供与游戏客户端API通信的工具集。

  • by johnnyinlee
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 johnnyinlee/lol-client-mcp

使用说明

LoL客户端MCP

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

概述

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

API信息可在https://developer.riotgames.com/docs/lol.

安装和使用

先决条件

  • Python 3.8或更高版本
  • 紫外线 -快速可靠的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_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客户端mcp”并连接

API工具清单

游戏数据

  • get_all_game_data()：Live League of Legends客户端数据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。

相关 MCP