MCP-Server

Was es ist

Das Repository enthält mcp_server.py, einen nativen stdio-Server für das Model Context Protocol. Es ist eine schlanke Schicht über dieser öffentlichen API — sie kommuniziert über HTTP mit einem laufenden Server, sodass ein KI-Assistent die DSA-Transparenzdaten über strukturierte Tool-Aufrufe statt über rohes HTTP erkunden kann. SQL wird nie offengelegt; jede Abfrage durchläuft dieselbe validierte Abfrageschicht wie der Rest der API.

Werkzeuge

• list_tables
  Listet die DSA-Berichtstabellen und den Datensatzzeitraum auf.
• describe_table
  Zeigt die abfragbaren Dimensionen und Kennzahlen einer Tabelle.
• dataset_overview
  Wichtigste Aggregate für den gesamten Datensatz.
• run_query
  Führt eine strukturierte (Einzeltabellen- oder zusammengesetzte) Abfrage aus und gibt JSON-Zeilen zurück.
• ask
  Stelle eine Frage in natürlicher Sprache; ein LLM übersetzt sie in eine validierte strukturierte Abfrage.
• register
  Erzeugt aus Name und E-Mail einen Demo-API-Schlüssel — schaltet die authentifizierten Werkzeuge unten frei.
• submit_query
  Reicht einen vollständigen asynchronen Abfrage-Job ein (ohne Zeilenlimit, CSV-Export, zusammengesetzte Abfragen) und gibt eine Job-ID zurück.
• poll_job
  Fragt einen eingereichten Job ab, bis er fertig ist, und gibt sein Ergebnis zurück.

submit_query, poll_job und ask benötigen einen API-Schlüssel; register erzeugt einen Demo-Schlüssel.

Einrichten

Fügen Sie den Server zu Ihrem MCP-Host hinzu (zum Beispiel die claude_desktop_config.json von Claude Desktop). Siehe docs/MCP.md für die vollständige Einrichtung und mcp-config.example.json im Repository für ein fertiges Beispiel.

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

Konfiguriert über TRANSPARENCY_API_URL, TRANSPARENCY_API_KEY und TRANSPARENCY_API_TIMEOUT. Seine Abhängigkeiten (mcp + httpx) liegen in requirements-mcp.txt, getrennt vom App-Image. Schlüssel nötig? API-Schlüssel erhalten →