MCP Football Server

Proporciona datos de fútbol utilizando el servicio API-Football.

Documentación

MCP Football Server

MCP Football Server es un servidor de herramientas ligero basado en el Model Context Protocol (MCP) que proporciona datos de fútbol a clientes y asistentes de IA a través de API-Football. Diseñado para analistas deportivos y usuarios en general, permite el acceso en tiempo real a calendarios, clasificaciones, equipos, jugadores y más.

Características

MCP Football Server expone un conjunto de herramientas que una IA o aplicación puede invocar para obtener datos de fútbol. Las características clave incluyen:

Calendarios por fecha
Clasificaciones de ligas
Información de equipos y jugadores
Traspasos, lesiones, enfrentamientos directos
Integración sencilla con clientes MCP

Configuración (Servidor Local)

Clonar e instalar dependencias

git clone https://github.com/yalmeidarj/mcp-football-server.git
cd mcp-football-server
npm install

Iniciar en desarrollo
```
npm run dev
```
O compilar para producción
```
npm run build
npm start
```

El servidor se comunica mediante STDIN/STDOUT usando MCP JSON-RPC. El paso de compilación transpila los archivos fuente al directorio build/, y npm start ejecuta el servidor compilado GitHub. Después de compilar, también puedes usar el comando football (definido como binario en el paquete) para iniciar el servidor GitHub.

Configuración del Cliente (Claude Desktop)

Para usar con Claude Desktop:

Añade lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "football": {
      "command": "node",
      "args": ["<path_to>/build/main.js"],
      "env": {
        "RAPIDAPI_KEY": "<your_rapidapi_key>",
        "RAPIDAPI_HOST": "api-football-v1.p.rapidapi.com"
      }
    }
  }
}

Claude lanzará el servidor automáticamente y usará sus herramientas para consultas relacionadas con el fútbol.

Stack Tecnológico

Node.js + TypeScript
MCP SDK para el servicio de herramientas basado en stdio
node-fetch para llamadas a la API
Zod para la validación de parámetros

Licencia

Publicado bajo la Licencia ISC.