Liga Record MCP

Un servidor MCP que expone mi equipo de fútbol fantástico de Liga Record a Claude: las reglas como herramientas, el reglamento como recurso y dos prompts para las decisiones que realmente tomo cada jornada.

La división sobre la que se basa: las reglas deterministas viven en el código, el criterio se queda con Claude. La legalidad de la formación, la aritmética del presupuesto y las sustituciones automáticas del §11 se calculan aquí y son autoritativas. A quién alinear y a quién vender es algo que Claude debe razonar, con datos reales y el reglamento real.

Consulta docs/PLANNING.md para el diseño y las ambigüedades de las reglas que esta lectura del reglamento deja abiertas.

Configuración

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

La instalación editable no es opcional: coloca liga_record_mcp en la ruta (el proyecto usa una estructura src/) y crea el lanzador liga-record-mcp al que apunta la configuración de MCP.

Tu equipo vive en data/squad.yaml. Copia data/squad.example.yaml y completa tus 23 jugadores: el cargador verifica el archivo contra el reglamento en cada lectura y nombra lo que falte, para que no tengas que contar a mano. Apunta LIGA_RECORD_SQUAD a un archivo diferente para gestionar un segundo equipo.

Related MCP server: wcprediction-mcp

Conectándolo a Claude

.mcp.json en la raíz del repositorio ya declara el servidor, así que Claude Code lo detecta cuando abres este proyecto: no se necesita CLI. Reinicia Claude Code después de la instalación y aprueba el servidor cuando se te pida.

La ruta en .mcp.json es absoluta y específica de la máquina. Windows resuelve un comando relativo contra el directorio del proceso lanzador, no el del servidor, por lo que una ruta relativa falla cuando la aplicación lo inicia. Edita esa ruta si mueves o clonas el repositorio.

Claude Desktop usa la misma forma en claude_desktop_config.json:

{
  "mcpServers": {
    "liga-record": {
      "command": "C:\\path\\to\\liga-record-mcp\\.venv\\Scripts\\liga-record-mcp.exe"
    }
  }
}

Luego pregúntale algo como: "¿Es legal mi once actual, y quién entra si Diogo Costa no juega?"

Lo que expone

Herramientas — get_squad, get_player, search_squad, validate_selection, simulate_autosubs, check_transfer, project_price, más dos que leen el sitio en vivo: search_market (todo el grupo de jugadores, con porcentajes de propiedad para encontrar diferenciales) y check_market_transfer (precia un intercambio con la cotización real en lugar de una escrita a mano). Cada lectura lleva una marca de tiempo as_of para que Claude pueda decir qué tan frescos están los datos en lugar de presentar un equipo almacenado como si fuera en vivo.

El cliente en vivo es de solo lectura por diseño. El sitio también expone endpoints de compra, venta y renegociación; sus contratos son conocidos, y deliberadamente no están implementados. Confirmar un traspaso sigue siendo un clic humano en el sitio de Record.

Recursos — ligarecord://regulamento (generado a partir de las mismas constantes que aplican las reglas, para que no pueda desviarse del código) y ligarecord://squad.

Prompts — pick_starting_xi, plan_transfers.

Pruebas

./.venv/Scripts/python.exe -m pytest -q

rules.py es puro: sin E/S, sin red, sin reloj, por lo que todo el reglamento se prueba sin tocar el sitio.

Estado

Los pasos 1–3 están hechos: el motor de reglas, la costura de la fuente de datos con un equipo YAML mantenido a mano, y el servidor MCP.

El paso 4 está a medias, y la mitad que más importa es la que se ha enviado. playersearch.ashx devuelve JSON limpio para todo el mercado de 498 jugadores y no requiere autenticación — verificado con una solicitud sin cookie —, por lo que el problema del token de sesión que el plan trataba como el riesgo principal del paso 4 simplemente no surge para los datos del mercado.

Leer el equipo de un equipo específico aún requiere iniciar sesión, por lo que data/squad.yaml sigue manteniéndose a mano. Esa es la pieza restante.