Historial de la Copa Mundial MCP

por Zafronix · npm: @zafronix/wc-mcp · Licencia MIT

Servidor del Protocolo de Contexto de Modelo (MCP) que brinda a Claude / Cursor / cualquier agente compatible con MCP acceso fundamentado a cada Copa Mundial de la FIFA desde 1930. 23 torneos. Más de 1.168 partidos. Más de 2.500 jugadores. 206 estadios. Todo expuesto como 15 herramientas tipadas para que el modelo deje de alucinar con plantillas, resultados, cuadros y altitudes de estadios.

Desarrollado por la API pública de la Copa Mundial de Zafronix: nivel gratuito con clave, 1.000 peticiones/día, sin tarjeta.

Por qué

Los LLM no son fiables en:

• Resultados exactos de torneos anteriores a la ventana de datos de entrenamiento.

• Detalles de las plantillas (números de camiseta, fechas de nacimiento, capitanes).

• Trayectorias de las rondas eliminatorias y resultados exactos.

• Datos de estadios (capacidad, altitud, año de inauguración).

Este MCP envuelve la API de WC de Zafronix para que el modelo pueda llamar a una herramienta y obtener la respuesta canónica en lugar de adivinar.

Related MCP server: mcp-claudinho

Instalación

npm install -g @zafronix/wc-mcp

O ejecútalo desde el código fuente:

git clone https://github.com/zafronix/wc-mcp
cd wc-mcp
npm install
npm run build

Obtén una clave API gratuita

https://api.zafronix.com/signup

1.000 peticiones/día en el nivel gratuito, sin tarjeta.

Configuración (Claude Desktop)

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "wc": {
      "command": "npx",
      "args": ["-y", "@zafronix/wc-mcp"],
      "env": {
        "WC_API_KEY": "zwc_pk_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Verás un icono 🔌 en la barra de entrada: haz clic en él para confirmar que wc está conectado.

Configuración (Cursor)

Configuración → MCP → Añadir nuevo servidor:

{
  "mcpServers": {
    "wc": {
      "command": "npx",
      "args": ["-y", "@zafronix/wc-mcp"],
      "env": { "WC_API_KEY": "zwc_pk_..." }
    }
  }
}

Herramientas

Ejemplos de prompts (en Claude Desktop, con este MCP habilitado)

• "Compara a Pelé y Messi en la Copa Mundial."

• "¿Cuál fue el estadio de la Copa Mundial a mayor altitud de la historia y cómo se compararon los totales de goles allí con las sedes al nivel del mar?"

• "Muéstrame la plantilla de Italia de 2006 con posiciones y clubes."

• "Traza el camino de Argentina hacia el título en 2022: cada partido, cada resultado."

• "Enumera todas las naciones africanas que han llegado a los cuartos de final de la Copa Mundial."

Desarrollo

npm run dev          # tsx watch mode
WC_API_KEY=... npm start

El servidor utiliza stdio. Puedes probarlo con la CLI de MCP:

npx @modelcontextprotocol/inspector npx tsx src/index.ts

Licencia

MIT.