K-AIR MCP
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: Governor SQL MCP
Werkzeuge
Werkzeug | Rolle |
| Liste der erlaubten Tabellen. Optional |
| Spaltentyp·PK·Kommentar. Fehlende koreanische Beschreibungen bleiben leer |
| DISTINCT für erlaubte Spalten. Maximal 200 |
| Zusammengesetztes SELECT. |
|
|
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.
Katalog- | Quelle |
| Analysemart (lokal |
| Erfassungs-Tibero. Wird in OA manchmal als oracle geschrieben |
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 HTTPVoraussetzung: 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/healthHealth: {"status":"ok","server":"kair-mcp-query","transport":"streamable-http","engines":["postgres"]}
CLI auf demselben PC (stdio, Standard):
python -m app.mainContainer-HTTP:
python -m app.main --transport httpMCP-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.
Variable | Rolle |
| HTTP |
| Mart-SELECT-Konto. Standard-Host |
|
|
| Zeilenobergrenze. Der Server kappt bei 200 |
| Erfassungs-Tibero. Nur wenn eine Verbindung vorhanden ist |
Die verbindliche Verbindungsquelle ist in OA SourceDbConn. Lokal sind es env/CLI.
Tests
python -m pytest tests -qBekannte Probleme·Einschränkungen
Punkt | Beschreibung | Status |
Tibero-Ausführung | Dialekt ( | Wird ergänzt, sobald Erfassungs-SID·JAR vorliegen |
Portal-Schlüssel·Audit |
| Nicht implementiert. Lokaler Schlüssel ist zur Entsorgung vorgesehen |
Freies SQL |
| Nicht aufgenommen |
Zeilenobergrenze 1000 | Gemini-Feedback | Nicht angewendet. 200 bleibt |
Verwandtes
robo-meta-api—POST /meta/catalogK-AIR-metadata-platform— Servingt2s_*K-AIR-Portal— Spätere verbindliche SchnittstellePOST /api/v1/mcp, Schlüsselverzeichnis
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Safe, read-only Postgres and MySQL access for AI agents. Audit log + column-level controls.
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Security layer for AI agents: Retrieve for controlled SQL reads, Guard for allow/deny writes.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to inspect schemas, walk Delta table history, run read-only DuckDB queries, and check data-quality and job-run status safely.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to safely query SQL databases through read-only tools for describing entities, reading records, and aggregating records, with view-based access and fail-closed per-user row-level security.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query Postgres, BigQuery and DuckDB read-only through policy-checked SQL, with AST-based guards that refuse writes and dangerous functions, column masking on the way out, and an audit log of every query. Also exposes schema browsing and query-planning tools so agents can see allowed tables, columns and costs before running anything.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to inspect database schemas and run strictly read-only SQL queries with guardrails against destructive statements, multi-statement chaining, and unbounded scans. Supports SQLite natively and PostgreSQL optionally.484 PyPIMIT