Integrations

Communicates with the League of Legends Live Client Data API to retrieve in-game data, offering tools to access game statistics, events, player information, abilities, runes, items, and scores during active gameplay.

Cliente LoL MCP

Un servidor MCP (Modelo-Controlador-Procesador) para acceder a los datos del cliente de League of Legends. Este servidor proporciona un conjunto de herramientas que se comunican con la API de datos del cliente en vivo de League of Legends para recuperar datos del juego.

Descripción general

Este proyecto accede a datos de juego en tiempo real mediante la API de datos de cliente en vivo del cliente de League of Legends. Utiliza el framework FastMCP para exponer varios endpoints como herramientas.

La información de la API se puede encontrar en https://developer.riotgames.com/docs/lol .

Instalación y uso

Prerrequisitos

Python 3.8 o superior
uv - Gestor de paquetes de Python rápido y confiable
- Instalación: pip install uv
Cliente de League of Legends instalado

Configuración del proyecto

Clonar este repositorio:

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

Instalar los paquetes necesarios usando uv:

uv pip install httpx fastmcp

Ejecución del servidor MCP

Para ejecutar directamente:

python main.py

Integración con Claude

Hay dos formas de usar esto con Claude:

1. Configuración del escritorio de Claude

Agregue lo siguiente a su archivo claude_desktop_config.json :

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

Importante : reemplace C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp con la ruta real a su proyecto.

2. Uso con aplicación web

Para conectar el servidor MCP a la aplicación web Claude:

Ejecute el servidor MCP:
python main.py
Configure la conexión al servidor en la interfaz web de Claude:
- Vaya a la configuración de MCP en la parte inferior al iniciar una conversación
- Seleccione 'lol-client-mcp' y conéctese

Lista de herramientas API

Datos del juego

get_all_game_data() : La API de datos de cliente en vivo de League of Legends cuenta con varios puntos finales que devuelven un subconjunto de los datos devueltos por el punto final /allgamedata. Este punto final es ideal para probar la API de datos de cliente en vivo, pero a menos que necesite todos los datos de este punto final, utilice uno de los puntos finales que se enumeran a continuación y que devuelven un subconjunto de la respuesta.
get_game_stats() : Datos básicos sobre el juego.
get_event_data() : obtiene una lista de eventos que han ocurrido en el juego.

Datos de jugadores activos

get_active_player() : obtiene todos los datos sobre el jugador activo.
get_active_player_name() : Devuelve el nombre del jugador.
get_active_player_abilities() : obtiene las habilidades del jugador activo.
get_active_player_runes() : recupera la lista completa de runas del jugador activo.

Lista de jugadores y datos individuales de los jugadores

get_player_list() : recupera la lista de héroes en el juego y sus estadísticas.
get_player_scores(riot_id) : recupera la lista de puntuaciones actuales del jugador.
get_player_summoner_spells(riot_id) : recupera la lista de hechizos de invocador del jugador.
get_player_main_runes(riot_id) : recupera las runas básicas de cualquier jugador.
get_player_items(riot_id) : recupera la lista de elementos del jugador.

Solución de problemas

Error de conexión : comprueba si el cliente de League of Legends se está ejecutando.
Error de tiempo de espera : Verifica que el juego haya comenzado. Esta API no funciona en la sala de juegos.

Precauciones

Esta API solo funciona cuando el cliente de League of Legends se está ejecutando y hay un juego en progreso.
Úselo de conformidad con las políticas de API de Riot Games.

Licencia

Todos los derechos pertenecen a Riot Games.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested