lol-client-mcp

lol-client-mcp

4
entertainment_and_media

LoL Client MCP is a server project designed to access and manipulate real-time data from the League of Legends client using the Live Client Data API. It features tools for game and player data retrieval, leveraging the FastMCP framework. This server is tailored for integration with the Claude application.

LoL Client MCP

An MCP server for accessing League of Legends client data using the Live Client Data API. The server uses the FastMCP framework to expose various endpoints as tools for accessing real-time game data.

Installation and Usage

Prerequisites

  • Python 3.8 or higher
  • uv Python package manager
  • League of Legends client installed

Project Setup

  1. Clone the repository and navigate into the project directory.
  2. Install required packages using uv.

Running the MCP Server

Run the server using a Python command.

Integration with Claude

  • Configure claude_desktop_config.json to run with Claude Desktop.
  • Connect to the Claude web application via MCP settings.

API Tools List

Game Data

  • Retrieve all game data, stats, and event data.

Active Player Data

  • Get data, player names, abilities, and runes for the active player.

Player Data

  • Retrieve player lists, scores, spells, runes, and items.

Troubleshooting

  • Connection errors may require checking the client status.
  • Timeout errors need game verification.

Precautions

  • Works only when the client is running and a game is in progress.
  • Adhere to Riot Games API policies.