LoL Client MCP

LoL Client MCP

一个用于访问 League of Legends 客户端数据的 MCP（Model-Controller-Processor）服务。该服务提供了一组工具，可通过 League of Legends Live Client Data API 通信来获取游戏内数据。

概览

本项目使用 League of Legends 游戏客户端的 Live Client Data API 访问实时游戏数据，并利用 FastMCP 框架将各种端点公开为工具。

API 信息请参阅 https://developer.riotgames.com/docs/lol。

安装和使用

前提条件

• Python 3.8 或更高版本
• uv - 快速可靠的 Python 包管理器
  • 安装：pip install uv
• 已安装 League of Legends 客户端

项目设置

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 Desktop

将以下内容添加到 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()：Live League of Legends Client Data API 提供了多个端点，每个端点返回 /allgamedata 端点所返回数据的一个子集。此端点非常适合用于测试 Live Client Data 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)：获取该玩家的装备列表。

故障排除

• 连接错误：检查 League of Legends 客户端是否正在运行。
• 超时错误：确认游戏是否已实际开始。此 API 在游戏大厅中无法使用。

注意事项

• 仅当 League of Legends 客户端正在运行且游戏进行中时，此 API 才能使用。
• 请遵守 Riot Games API 政策。

许可证

所有权利均归 Riot Games 所有。