K-AIR MCP

Dies ist der offizielle MCP-Server, der es Agenten erlaubt, im Datenhub nur nachzuschlagen. Es gibt nur eine Schnittstelle, und intern unterscheidet der Server zwischen Postgres (Analysemart) und Tibero (Erfassung) als Katalogquelle engine. SQL-Strings werden nicht akzeptiert.

Die Rolle ist ähnlich wie bei robo-meta-api T2SQL·query_execute, aber der Server erzeugt kein SQL, sondern setzt SELECT aus Tool-Argumenten zusammen. Der Portal-POST /mcp-Mockup wird nicht als verbindliche Vorlage kopiert.

Update-Historie: change_log.md

Was dieser Dienst tut

• Stellt dem Agenten Werkzeuge für Tabellenlisten, Spaltendetails, eindeutige Werte, begrenzte SELECTs und Aggregationen bereit.

• Erlaubte Tabellen = POST /meta/catalog ∩ Tabellen·Spalten, die in der jeweiligen Engine-Quelle tatsächlich existieren.

• HTTP ist Streamable HTTP (/mcp) + X-Api-Key. stdio ist für IDE auf demselben PC.

• Die KI kennt nur die MCP-URL und den API-Key. DB-Passwörter und die robo-Adresse erscheinen nicht in den Tool-Ergebnissen.

Was nicht getan wird: freies SQL, DML/DDL, Dump/Senden, Betriebs-Tibero, Abfragen von t2s·argus_catalog-Daten, Aufteilung des MCP pro Engine.

Related MCP server: SQLite Read-Only MCP Server

Werkzeuge

Zeilenobergrenze 200. Schreibgeschützt (default_transaction_read_only), statement_timeout 15 Sekunden. filters.op: eq, ne, gt, gte, lt, lte, like, in, is_null, is_not_null.

Engine-Unterscheidung

/meta/catalog sources[].engine ist die verbindliche Quelle. Der Agent wählt die Engine nicht aus.

Fehlt die Engine oder ist der Wert unbekannt, wird sie aus der Liste entfernt. Tibero-Tabellen werden nicht mit Postgres-Tabellen vermischt, selbst wenn sie denselben Namen haben.

Lokal gibt es nur Postgres. Ohne Tibero-Verbindung oder JDBC erscheinen die Tibero-Quellen des Katalogs nicht in der Liste. JDBC-JARs werden nicht in das Image aufgenommen.

Konfiguration

app/                 FastMCP 서버 (stdio / Streamable HTTP)
tests/               단위·계약 테스트
docker-compose.yml   네트워크용 http :8110
mcp.cursor.example.json       같은 PC stdio
mcp.cursor.http.example.json  다른 PC HTTP

Voraussetzung: Netzwerk von robo-meta-api und kair-metadata-platform_control-plane. Die Datenseite ist lokal kair-postgis-16 (Host 5434). Portal·OASIS·Betriebs-Tibero fallen nicht in den Umfang dieses Repositories.

Ausführung

copy .env.example .env
# MCP_API_KEYS · MCP_PG_* 실제 값만 채움. 따옴표 넣지 않음
docker compose up -d --build
curl.exe -fsS http://127.0.0.1:8110/health

Health: {"status":"ok","server":"kair-mcp-query","transport":"streamable-http","engines":["postgres"]}

CLI auf demselben PC (stdio, Standard):

python -m app.main

Container-HTTP:

python -m app.main --transport http

MCP-Registrierung

Gleicher PC (stdio empfohlen). Der Container muss laufen. URL·Schlüssel·.env werden nicht eingetragen.

{
  "mcpServers": {
    "kair-query": {
      "command": "docker",
      "args": ["exec", "-i", "kair-mcp-query", "python", "-m", "app.main", "--transport", "stdio"]
    }
  }
}

Anderer PC (Streamable HTTP). DB-Passwort wird nicht eingetragen.

{
  "mcpServers": {
    "kair-query": {
      "url": "http://<MCP띄운PC의IP>:8110/mcp",
      "headers": {
        "X-Api-Key": "<MCP_API_KEYS 값만>"
      }
    }
  }
}

mcp.json ist JSON, daher werden Schlüssel in "…" gesetzt. Die Werte, die der Server empfängt, sind Schlüssel ohne Anführungszeichen.

Einstellungen

.env.example wird in eine von Git ausgeschlossene .env kopiert. Passwörter und API-Keys werden nicht in Code und Git-verfolgten Dokumenten gespeichert.

Die verbindliche Verbindungsquelle ist in OA SourceDbConn. Lokal sind es env/CLI.

Tests

python -m pytest tests -q

Bekannte Probleme·Einschränkungen

Verwandtes

• robo-meta-api — POST /meta/catalog

• K-AIR-metadata-platform — Serving t2s_*

• K-AIR-Portal — Spätere verbindliche Schnittstelle POST /api/v1/mcp, Schlüsselverzeichnis