Server MCP

Che cos'è

Il repository include mcp_server.py, un server stdio nativo del Model Context Protocol. È un livello leggero su questa API pubblica: comunica con un server in esecuzione tramite HTTP, in modo che un assistente di IA possa esplorare i dati di trasparenza del DSA mediante chiamate a strumenti strutturate anziché HTTP grezzo. Non viene mai esposto alcun SQL; ogni query passa per lo stesso livello di query validato del resto dell'API.

Strumenti

• list_tables
  Elenca le tabelle dei report del DSA e il periodo del set di dati.
• describe_table
  Mostra le dimensioni e le misure interrogabili di una tabella.
• dataset_overview
  Aggregati principali dell'intero set di dati.
• run_query
  Esegue una query strutturata (di una tabella o composta) e restituisce righe JSON.
• ask
  Poni una domanda in linguaggio naturale; un LLM la traduce in una query strutturata validata.
• register
  Genera una chiave API di dimostrazione a partire da un nome e un'email: sblocca gli strumenti autenticati qui sotto.
• submit_query
  Invia un lavoro di query asincrono completo (senza limite di righe, esportazione CSV, query composte) e ottieni un id di lavoro.
• poll_job
  Sonda un lavoro inviato finché non termina e restituisce il suo risultato.

submit_query, poll_job e ask richiedono una chiave API; register ne genera una di dimostrazione.

Come collegarlo

Aggiungi il server al tuo host MCP (per esempio il claude_desktop_config.json di Claude Desktop). Consulta docs/MCP.md per la configurazione completa e mcp-config.example.json nel repository per un esempio pronto all'uso.

{
  "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"
      }
    }
  }
}

Si configura tramite TRANSPARENCY_API_URL, TRANSPARENCY_API_KEY e TRANSPARENCY_API_TIMEOUT. Le sue dipendenze (mcp + httpx) si trovano in requirements-mcp.txt, separate dall'immagine dell'app. Ti serve una chiave? Ottieni una chiave API →