league-data-mcp

# League-Data-MCP A Model Context Protocol (MCP) server that provides access to League of Legends game data through the Riot Games API. ## Features - **Player's PUUID Lookup**: Get player's PUUID using game names and tag lines - **Match History List**: Retrieve match lists for players with optional filtering - **Match Details**: Get detailed match information including statistics and game data - **Match Summary List**: Get truncated match data with player-specific context (optimized for large datasets) ## Prerequisites - Python 3.13+ - Riot Games API key (get one from [Riot Developer Portal](https://developer.riotgames.com/)) - MCP-compatible client (like Claude Desktop) ## Installation ### Method 1: Install from PyPI (Recommended) ```bash pip install league-data-mcp ``` ### Method 2: Install with uvx ```bash uvx install league-data-mcp ``` ### Method 3: Development Installation 1. **Clone the repository** ```bash git clone https://github.com/syy674998887/league-data-mcp.git cd league-data-mcp ``` 2. **Install dependencies** ```bash uv sync ``` 3. **Set environment variable** ```bash export API="Your Riot API key here" ``` ## Configuration ### For Claude Desktop/Cherry Studio etc. 4. **Configure MCP Client** Add the server configuration to your MCP client: ```json { "mcpServers": { "League-Data-MCP": { "command": "uvx", "args": ["league-data-mcp@latest"], "env": { "API": "Your Riot API key here" } } } } ``` ## Available Tools ### `get_puuid` Get player PUUIDs by their game names and tag lines (supports batch queries). **Parameters:** - `players` (List[dict]): List of player dictionaries with `game_name` and `tag_line` keys **Example:** ```python get_puuid([ {"game_name": "Faker", "tag_line": "KR1"}, {"game_name": "Untargetable", "tag_line": "666"} ]) ``` ### `get_match_list` Get a list of matches for a player by their PUUID. **P…