FC 26 MCP

Servidores MCP para EA SPORTS FC 26. Funciona con Claude, Codex, Pi, Cursor, Cline, Windsurf y cualquier otro agente compatible con el Model Context Protocol.

Se incluyen dos servidores:

1. fc26-mcp-file — analiza y edita archivos Squads* en formato FBCHUNKS/T3DB.

2. fc26-mcp-live — controla FC 26 a través de la API Lua del Live Editor de xAranaktu mientras el juego se ejecuta.

Instalación

Desde PyPI:

pip install fc26-mcp

Desde GitHub:

pip install git+https://github.com/INSANE0777/Fc26-live-editor-mcp.git

Desde el código fuente:

git clone https://github.com/INSANE0777/Fc26-live-editor-mcp.git
cd fc26-mcp
pip install -e .

Related MCP server: MCP Partidos de Fútbol

Editor GUI

Una interfaz gráfica de escritorio (tkinter, sin dependencias adicionales) para abrir un archivo de plantilla y editarlo completamente desde la interfaz de usuario — sin necesidad de un cliente MCP ni Live Editor:

fc26-mcp-gui                      # open via file dialog
fc26-mcp-gui "path/to/Squads..."  # open a specific squad file directly

Funcionalidades:

• Navegar / buscar / editar / eliminar filas en las 78 tablas de la base de datos (filtro por tabla)

• Búsqueda de jugadores por nombre o ID, mostrando el club actual y estado de cesión

• Traspasos con un clic — selecciona un jugador + equipo destino, se aplica a todos los vínculos del club (los vínculos con la selección nacional se conservan automáticamente)

• Finalizar cesiones — elimina las filas de playerloans

• Copia de seguridad automática antes de guardar, más un botón manual de copia de seguridad

• Indicador de cambios sin guardar; Guardar escribe en el mismo archivo (o una copia)

Nota: la tabla dcplayernames del archivo de plantilla está incompleta (~6k de ~22k jugadores), por lo que muchos jugadores muestran ? como nombre — busca por ID de jugador para esos casos.

Rutas

El paquete usa rutas de marcador de posición. Configura tus rutas reales mediante indicadores de línea de comandos o variables de entorno:

Inicio rápido

1. MCP de archivo de plantilla

fc26-mcp-file --squad-file "C:\Path\To\SquadsFile"

Los metadatos incluidos de FC 26 se usan automáticamente. Puedes sobrescribirlos con --meta-file.

2. Puente MCP de Live Editor

1. Inicia FC 26 e inyecta Live Editor.

2. Carga el Modo Carrera.

3. Instala el puente Lua en Live Editor una vez:

fc26-mcp-live --install-lua "C:\Path\To\Your\FC 26 LE\lua\scripts"

4. En Live Editor, ve a Features → Lua Engine y ejecuta le_bridge.lua.

5. Inicia el servidor MCP:

fc26-mcp-live --bridge-root "C:\Path\To\Your\FC 26 LE\le_bridge"

Herramientas

Analizador de archivos

• list_clubs

• search_players

• get_player_club

• plan_transfers

• apply_transfers

Puente de Live Editor (28 herramientas)

• Núcleo: le_ping, le_list_clubs, le_search_players, le_get_player_club

• Traspasos/cesiones: le_transfer_player, le_loan_player, le_release_player, le_terminate_loan

• Listas: le_add_to_transfer_list, le_add_to_loan_list, le_remove_from_lists, le_is_transfer_listed, le_is_loan_listed

• Estado del jugador: le_set_player_sharpness, le_set_player_morale, le_set_player_form, le_set_player_fitness

• Presupuesto: le_get_transfer_budget, le_set_transfer_budget

• Editor de base de datos: le_get_db_tables, le_get_db_fields, le_get_db_rows, le_edit_db_field, le_insert_db_row, le_delete_db_row

• Estadísticas: le_get_players_stats, le_get_player_stats

• Usuario avanzado: le_execute_lua

Consulta README_LE_BRIDGE.md para documentación detallada de Live Editor.

Configuración del cliente MCP

Usa mcp_config.json como plantilla, o añade estos servidores manualmente:

{
  "mcpServers": {
    "fc26-file": {
      "command": "fc26-mcp-file",
      "args": [
        "--squad-file",
        "C:\Path\To\SquadsFile"
      ]
    },
    "fc26-live": {
      "command": "fc26-mcp-live",
      "args": [
        "--bridge-root",
        "C:\Path\To\Your\FC 26 LE\le_bridge"
      ]
    }
  }
}

Claude Desktop

Abre claude_desktop_config.json y añade los bloques de servidor anteriores.

Cursor

Abre Cursor Settings → MCP → Add MCP Server, pega el comando y los argumentos.

Cline / Roo Code

Añade el JSON a tu archivo de configuración MCP.

Pi

Pi detecta servidores MCP stdio desde mcp_config.json o la configuración de tu espacio de trabajo.

Variables de entorno

Seguridad

• Siempre haz copias de seguridad de tus archivos de plantilla y partidas guardadas de Modo Carrera antes de editar.

• Las herramientas de Modo Carrera solo funcionan dentro del Modo Carrera.

• le_execute_lua puede ejecutar código arbitrario — úsalo con cuidado.

Licencia

MIT