LoL客户端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 所有。