boe-mcp

boe-mcp

Un servidor MCP (Model Context Protocol) que proporciona a Claude Code — o a cualquier cliente MCP — datos en vivo del Banco de Inglaterra: el tipo base (nivel actual, historial de cambios, estadísticas de cualquier período y el tipo vigente en cualquier fecha pasada), cualquier serie de la base de datos estadística IADB del BoE (SONIA, tipos de cambio, tipos hipotecarios cotizados y miles más, con un catálogo curado para empezar), y el calendario de reuniones del Comité de Política Monetaria. Funciona sobre stdio por defecto (con un modo HTTP Streamable opcional para alojamiento remoto), no requiere clave API ni configuración, y almacena en caché las respuestas en memoria para que las preguntas repetidas no vuelvan a consultar al BoE.

Publicado en npm como boe-mcp con procedencia de compilación — instálalo y ejecútalo con npx -y boe-mcp.

Herramientas

get_series acepta cualquier código IADB válido (no solo los catalogados); un código desconocido o vacío devuelve un mensaje limpio de Unknown or empty IADB series "XXXX" — use list_series for known codes. Usa list_series para descubrir códigos.

Si el BoE no está accesible y existe un valor previamente almacenado en caché, las herramientas sirven los datos en caché con "stale": true para que el llamador pueda señalar la advertencia. Sin caché en absoluto, devuelven un mensaje de error limpio.

Instalación

Añade a tu Claude Code settings.json:

{
  "mcpServers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

O usa la CLI:

claude mcp add boe -- npx -y boe-mcp

{
  "mcpServers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

{
  "mcpServers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

{
  "servers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

Modo HTTP (alojamiento remoto)

Por defecto, el servidor habla MCP sobre stdio como proceso hijo del cliente. Para alojarlo de forma remota, inícialo en modo HTTP Streamable:

npx -y boe-mcp --http                  # listen on http://127.0.0.1:3000/mcp
npx -y boe-mcp --http 8080             # explicit port
BOE_MCP_HTTP_PORT=8080 npx -y boe-mcp  # env var instead of the flag

Endpoints: POST /mcp (JSON-RPC), GET /healthz (devuelve ok, para comprobaciones de salud de la plataforma de alojamiento). El transporte es sin estado — cada POST lo atiende una instancia de servidor nueva, por lo que no hay sesiones que reanudar ni flujo SSE; GET/DELETE /mcp devuelven 405. Esto hace que las instancias sean seguras para escalar horizontalmente detrás de un balanceador de carga.

Pruébalo con curl:

curl -X POST http://127.0.0.1:3000/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Seguridad: el enlace por defecto de 127.0.0.1 solo acepta conexiones desde la máquina local, y la protección contra reenlace de DNS (validación de cabecera Host) se activa automáticamente para enlaces de bucle local. Establecer BOE_MCP_HTTP_HOST=0.0.0.0 expone el servidor, sin autenticación, a todas las redes a las que está conectada la máquina — hazlo solo detrás de un proxy inverso o cortafuegos que controle quién puede acceder (la protección contra reenlace de DNS está desactivada para enlaces que no son de bucle local, ya que el servidor no puede conocer el nombre de host público legítimo).

Configuración

Fuentes de datos

• Tipo base: la Base de Datos Estadística Interactiva del Banco de Inglaterra (IADB), serie IUDBEDR, a través de su endpoint CSV público. Sin autenticación, sin clave. Advertencia honesta: la IADB no está documentada oficialmente como API pública — ha sido estable durante muchos años y se usa ampliamente, pero el Banco no promete compatibilidad, por lo que un cambio disruptivo es posible en principio.
• Fechas del MPC: extraídas de la página pública de fechas del MPC del BoE. El analizador evita deliberadamente depender del marcado de la página (escanea el texto visible en busca de fechas), por lo que los rediseños cosméticos no lo romperán.

Ejecución desde el código fuente

git clone https://github.com/moureauf/boe-mcp.git
cd boe-mcp
npm install
npm run build
npm start            # runs the stdio server

Contribución y publicación

Consulta CONTRIBUTING.md para el flujo de trabajo de desarrollo (hacer cambios, probar, añadir herramientas, versionado) y cómo el pipeline de publicación conecta GitHub, npm y el registro MCP. La publicación está automatizada: empujar una etiqueta v* ejecuta .github/workflows/publish.yml, que compila, prueba y publica en npm mediante publicación de confianza (OIDC — sin secreto de token, con atestación de procedencia) y en el registro MCP oficial. Los comandos exactos y la configuración única están en RELEASING.md.

Licencia

MIT