Lol Client MCP

🚀 LoL Client MCP Server

An MCP (Model-Controller-Processor) server for accessing League of Legends client data. This server offers a series of tools that retrieve in-game data by communicating with the League of Legends Real-Time Client Data API.

🚀 Quick Start

This project uses the Real-Time Client Data API of the League of Legends game client to access real-time game data. It leverages the FastMCP framework to expose various endpoints as tools.

For API-related information, refer to https://developer.riotgames.com/docs/lol.

📦 Installation

Prerequisites

• Python 3.8 or higher
• uv - A fast and reliable Python package manager
  • Installation: pip install uv
• A installed League of Legends client

Project Setup

1. Clone this repository:

git clone https://github.com/yourusername/lol-client-mcp.git
cd lol-client-mcp

2. Install the required packages using uv:

uv pip install httpx fastmcp

Running the MCP Server

Run directly:

python main.py

Integration with Claude

There are two ways to use this project in combination with Claude:

1. Claude Desktop Configuration

Add the following content to the claude_desktop_config.json file:

{
    "mcpServers": {
        "lol-client-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

Note: Replace C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp with the actual path of your project.

2. Integration with Web Application

To connect the MCP server to the Claude web application:

1. Run the MCP server:

python main.py

2. Configure the server connection in the Claude web interface:
   • Enter the MCP settings at the bottom when starting a conversation.
   • Select 'lol-client-mcp' and connect.

💻 Usage Examples

API Tool List

Game Data

• get_all_game_data(): The League of Legends Real-Time Client Data API has multiple endpoints that return a portion of the response from the /allgamedata endpoint. This endpoint is ideal for testing the Real-Time Client Data API, but unless you really need all the data from this endpoint, use one of the other endpoints listed below.
• get_game_stats(): Basic data of the game.
• get_event_data(): Retrieve a series of events that occur in the game.

Current Player Data

• get_active_player(): Retrieve all data of the current player.
• get_active_player_name(): Return the player's name.
• get_active_player_abilities(): Retrieve the skill information of the current player.
• get_active_player_runes(): Retrieve the complete rune list of the current player.

Player List and Single Player Data

• get_player_list(): Retrieve the list of heroes and their states in the game.
• get_player_scores(riot_id): Retrieve the current game score list of the specified player.
• get_player_summoner_spells(riot_id): Retrieve the summoner spell list of the specified player.
• get_player_main_runes(riot_id): Retrieve the main rune information of any player.
• get_player_items(riot_id): Retrieve the item list of the specified player.

📚 Documentation

Troubleshooting

• Connection Error: Check if the League of Legends client is running.
• Timeout Error: Confirm that the game has actually started. This API does not work in the game lobby.

Important Note

• This API can only be used when the League of Legends client is running and the game is in progress.
• Please comply with the relevant policies of the Riot Games API when using it.

📄 License

All rights reserved by Riot Games.