Lol Client MCP

一个基于FastMCP框架的MCP服务器，用于通过英雄联盟客户端API获取实时游戏数据，提供多种游戏数据查询工具。

游戏与游戏化开发者工具 #游戏数据 #实时API #英雄联盟 #MCP服务 .Python

评分 : 2分

下载量 : 11

更新时间 : 2025-04-28

什么是LoL Client MCP?

LoL Client MCP是一个中间服务器，它连接英雄联盟客户端和用户界面，提供实时游戏数据查询功能。通过简单的API调用，您可以获取当前游戏中的各种信息，如玩家数据、游戏状态等。

如何使用LoL Client MCP?

您可以通过两种方式使用：1) 配置Claude桌面应用连接 2) 通过网页界面连接。需要先启动英雄联盟游戏客户端并进入游戏。

适用场景

适合游戏数据分析、实时状态监控、游戏辅助工具开发等场景。特别适合想要获取英雄联盟实时游戏数据的开发者和高级玩家。

主要功能

游戏数据查询提供完整的游戏状态信息，包括游戏时间、地图信息等

玩家数据查询可以获取当前玩家和所有玩家的详细信息，包括装备、技能、符文等

游戏事件查询实时获取游戏中发生的事件，如击杀、推塔等

优势与局限性

优势

实时获取游戏数据，延迟低

数据全面，覆盖游戏各个方面

易于集成到现有系统中

局限性

只能在游戏进行中使用，大厅无效

需要英雄联盟客户端正在运行

部分数据可能需要游戏权限

如何使用

安装准备

确保已安装Python 3.8+和英雄联盟客户端

克隆仓库

获取项目代码

安装依赖

安装必要的Python包

启动服务器

运行主程序

使用案例

监控玩家状态实时获取当前玩家的生命值、魔法值和装备信息

分析游戏事件查询最近发生的游戏事件，如击杀、助攻等

常见问题

为什么我连接不上服务器?

获取数据时出现超时错误怎么办?

是否需要Riot Games的官方授权?

🚀 LoL 客户端 MCP 服务器

这是一个用于访问《英雄联盟》（League of Legends）客户端数据的 MCP（模型 - 控制器 - 处理器）服务器。它提供了一系列工具，通过与《英雄联盟》实时客户端数据 API 通信，帮助用户检索游戏内数据。

🚀 快速开始

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

API 相关信息可参考 👉 Riot Games 开发者文档。

📦 安装指南

先决条件

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 集成

有以下两种方式使用此项目与 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 网页应用：

运行 MCP 服务器：

python main.py

在 Claude 网页界面中配置服务器连接：
- 开始对话时在底部进入 MCP 设置
- 选择 'lol-client-mcp' 并连接

💻 使用示例

基础用法

以下是一些常用 API 工具的调用示例：

# 获取所有游戏数据
all_game_data = get_all_game_data()

# 获取游戏基本数据
game_stats = get_game_stats()

# 获取当前玩家的所有数据
active_player = get_active_player()

高级用法

# 获取指定玩家的物品列表
riot_id = "example_riot_id"
player_items = get_player_items(riot_id)

# 获取指定玩家当前的游戏得分列表
player_scores = get_player_scores(riot_id)

📚 详细文档

API 工具列表

游戏数据

get_all_game_data(): 《英雄联盟》实时客户端数据 API 有多个端点，这些端点返回 /allgamedata 端点响应的一部分。此端点适合测试实时客户端数据 API，但除非您确实需要从该端点获取所有数据，建议使用以下列出的其他端点之一。
get_game_stats(): 获取游戏的基本数据。
get_event_data(): 获取游戏中发生的一系列事件。