MCP — Conectar asistentes de IA — Monitorizador de Datos Abiertos

Qué es esto

MCP (Model Context Protocol) es un estándar abierto que permite a un asistente de IA conectarse a fuentes de datos externas y usarlas como contexto en una conversación.

Nuestro servidor MCP es un envoltorio sobre la API REST pública. Te permite hacer preguntas en lenguaje natural y que el asistente busque, filtre y compare datasets sin que tengas que escribir curl.

Solo lectura · sin autenticación
Transporte Streamable HTTP (spec MCP 2025-06-18)
Límite de uso: 60 peticiones por minuto y por IP
Datos bajo CC BY 4.0, código del wrapper bajo Apache 2.0
Endpoint público: https://spain.meloda.org/mcp

Qué puedes preguntar

Ejemplos de consultas que el asistente resolverá llamando a las herramientas adecuadas:

«Lista los portales catalanes con MELODA medio > 20»
«Datasets en formato CSV con licencia CC-BY publicados en 2026»
«¿Qué portal andaluz tiene mejor puntuación de reutilización?»
«Recursos GeoJSON sobre transporte en la Comunidad de Madrid»
«Compara la cobertura de datasets entre Barcelona y Valencia»
«¿Cuándo se actualizó por última vez el catálogo de la Junta de Andalucía?»

Cómo conectarte

OPCIÓN 1 · MÁS FÁCIL

Claude.ai (web)

Añade un conector personalizado en la configuración de tu cuenta y pega esta URL:

https://spain.meloda.org/mcp

OPCIÓN 2 · LOCAL

Claude Desktop

Necesitas uv instalado. Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "meloda": {
      "command": "uvx",
      "args": ["meloda-mcp"]
    }
  }
}

OPCIÓN 3 · DEV

Cursor / VSCode / otros

Cualquier cliente MCP compatible con transporte HTTP puede apuntar a:

https://spain.meloda.org/mcp

Consulta la documentación de tu cliente para configurar el endpoint MCP.

Herramientas (tools) expuestas

Tool	Qué hace	Equivalente REST
`search_datasets`	Búsqueda libre + filtros (portal, formato, licencia, MELODA, geolocalización, fecha, tema). Devuelve resultados paginados.	`GET /datasets`
`get_dataset`	Metadatos completos DCAT-AP de un dataset.	`GET /datasets/{id}`
`get_dataset_resources`	Distribuciones descargables (CSV, JSON, SHP, ...) con su URL y formato.	`GET /datasets/{id}/resources`
`list_portals`	Listado de los 43 portales monitorizados, filtrable por región y tecnología (CKAN, Socrata, OpenDataSoft, ...).	`GET /portals`
`get_portal`	Detalle de un portal: histórico de harvest y desglose MELODA D1-D6.	`GET /portals/{id}`
`list_portal_datasets`	Datasets de un portal concreto, con paginación.	`GET /portals/{id}/datasets`
`get_global_stats`	KPIs globales del catálogo: total de datasets, distribución MELODA, frescura.	`GET /stats`

Verificar que funciona

Handshake mínimo desde tu terminal:

curl -X POST https://spain.meloda.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"initialize",
       "params":{"protocolVersion":"2025-06-18",
                 "capabilities":{},
                 "clientInfo":{"name":"x","version":"0"}}}'

Una respuesta válida confirma que tu red puede llegar al servidor y que el protocolo está activo.

Código y contribución

El servidor está implementado en Python (FastMCP + FastAPI) y es de código abierto.

Repositorio: albertoabellagarcia/meloda
Licencia código: Apache 2.0
Issues y propuestas de mejora: GitHub Issues

¿Echas de menos alguna funcionalidad? Abre un issue describiendo tu caso de uso.

Conecta tu asistente de IA al Monitorizador