Servidor MCP

Qué es

El repositorio incluye mcp_server.py, un servidor stdio nativo del Model Context Protocol. Es una capa ligera sobre esta API pública: se comunica con un servidor en ejecución por HTTP, de modo que un asistente de IA puede explorar los datos de transparencia del DSA mediante llamadas a herramientas estructuradas en lugar de HTTP en crudo. Nunca se expone SQL; cada consulta pasa por la misma capa de consultas validada que el resto de la API.

Herramientas

• list_tables
  Lista las tablas de informes del DSA y el período del conjunto de datos.
• describe_table
  Muestra las dimensiones y medidas consultables de una tabla.
• dataset_overview
  Agregados principales de todo el conjunto de datos.
• run_query
  Ejecuta una consulta estructurada (de una tabla o compuesta) y devuelve filas JSON.
• ask
  Haz una pregunta en lenguaje natural; un LLM la traduce en una consulta estructurada validada.
• register
  Genera una clave de API de demostración a partir de un nombre y un correo: desbloquea las herramientas autenticadas de abajo.
• submit_query
  Envía un trabajo de consulta asíncrono completo (sin límite de filas, exportación CSV, consultas compuestas) y obtén un id de trabajo.
• poll_job
  Sondea un trabajo enviado hasta que termina y devuelve su resultado.

submit_query, poll_job y ask necesitan una clave de API; register genera una de demostración.

Cómo conectarlo

Añade el servidor a tu host MCP (por ejemplo, el claude_desktop_config.json de Claude Desktop). Consulta docs/MCP.md para la configuración completa y mcp-config.example.json en el repositorio para un ejemplo listo para usar.

{
  "mcpServers": {
    "transparency-report-api": {
      "command": "/absolute/path/to/transparency-report-api/.venv-mcp/bin/python",
      "args": ["/absolute/path/to/transparency-report-api/mcp_server.py"],
      "env": {
        "TRANSPARENCY_API_URL": "https://your-deployment.example",
        "TRANSPARENCY_API_KEY": "momo"
      }
    }
  }
}

Se configura mediante TRANSPARENCY_API_URL, TRANSPARENCY_API_KEY y TRANSPARENCY_API_TIMEOUT. Sus dependencias (mcp + httpx) están en requirements-mcp.txt, separadas de la imagen de la app. ¿Necesitas una clave? Obtener una clave de API →