lol-client-mcp Public

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

1. Clonar este repositorio:

2. Instalar los paquetes necesarios usando uv:

Ejecución del servidor MCP

Para ejecutar directamente:

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 :

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:

1. Ejecute el servidor MCP:
   python main.py
2. 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.