K-AIR MCP
K-AIR MCP
这是供代理仅对数据枢纽进行查询而开放的官方 MCP 服务器。入口只有一个,目录源 engine 会在内部区分 Postgres(分析数据集市)和 Tibero(采集)。不接受 SQL 字符串。
与 robo-meta-api 的 T2SQL·query_execute 角色类似,但服务器不生成 SQL,而是通过工具参数组装 SELECT。不复制门户 POST /mcp 原型作为正本。
更新历史: change_log.md
该服务的工作内容
向代理提供表列表·列详情·唯一值·受限 SELECT·聚合工具。
允许的表 =
POST /meta/catalog∩ 对应引擎数据源中实际存在的表·列。HTTP 采用 Streamable HTTP(
/mcp)+X-Api-Key。stdio 用于同一台 PC 上的 IDE。AI 只知道 MCP URL 和 API Key。DB 密码·robo 地址不会出现在工具结果中。
不做的事:自由 SQL、DML/DDL、dump/发送、运营 Tibero、t2s·argus_catalog 数据查询、按引擎拆分 MCP。
Related MCP server: Governor SQL MCP
工具
工具 | 作用 |
| 允许的表列表。可选 |
| 列类型·主键·注释。没有的韩文说明留空 |
| 允许列的 DISTINCT。最多 200 |
| 组装 SELECT。 |
|
|
行数上限 200。只读(default_transaction_read_only),statement_timeout 15 秒。filters.op:eq、ne、gt、gte、lt、lte、like、in、is_null、is_not_null。
引擎区分
/meta/catalog 的 sources[].engine 是正本。代理不选择引擎。
目录 | 数据源 |
| 分析数据集市(本地为 |
| 采集 Tibero。OA 中有时会写成 oracle |
引擎缺失或为未知值时,从列表中排除。即使 Tibero 表与 Postgres 实际存在的表同名,也不会混在一起。
本地只有 Postgres。如果没有 Tibero 连接·JDBC,目录中的 Tibero 源不会出现在列表中。JDBC JAR 不放入镜像。
配置
app/ FastMCP 서버 (stdio / Streamable HTTP)
tests/ 단위·계약 테스트
docker-compose.yml 네트워크용 http :8110
mcp.cursor.example.json 같은 PC stdio
mcp.cursor.http.example.json 다른 PC HTTP前提:robo-meta-api 与 kair-metadata-platform_control-plane 网络。数据面为本地 kair-postgis-16(主机 5434)。门户·OASIS·运营 Tibero 不在本仓库范围内。
运行
copy .env.example .env
# MCP_API_KEYS · MCP_PG_* 실제 값만 채움. 따옴표 넣지 않음
docker compose up -d --build
curl.exe -fsS http://127.0.0.1:8110/health健康检查:{"status":"ok","server":"kair-mcp-query","transport":"streamable-http","engines":["postgres"]}
同一台 PC 上的 CLI(stdio,默认):
python -m app.main容器 HTTP:
python -m app.main --transport httpMCP 注册
同一台 PC(推荐 stdio)。容器必须处于运行状态。不填写 URL·密钥·.env。
{
"mcpServers": {
"kair-query": {
"command": "docker",
"args": ["exec", "-i", "kair-mcp-query", "python", "-m", "app.main", "--transport", "stdio"]
}
}
}其他 PC(Streamable HTTP)。不填写 DB 密码。
{
"mcpServers": {
"kair-query": {
"url": "http://<MCP띄운PC의IP>:8110/mcp",
"headers": {
"X-Api-Key": "<MCP_API_KEYS 값만>"
}
}
}
}mcp.json 是 JSON,因此密钥需要用 "…" 包裹。服务器接收的值是不带引号的密钥。
设置
将 .env.example 复制为 Git 排除的 .env。密码·API Key 不存储在代码和 Git 跟踪的文档中。
变量 | 作用 |
| HTTP |
| 数据集市 SELECT 账户。默认主机 |
|
|
| 行数上限。服务器截断为 200 |
| 采集 Tibero。仅在存在连接时 |
连接正本在 OA 中是 SourceDbConn。本地使用 env/CLI。
测试
python -m pytest tests -q已知问题·限制
项目 | 说明 | 状态 |
Tibero 运行 | 有方言( | 采集 SID·JAR 到位后继续 |
门户密钥·审计 |
| 未实现。本地密钥待废弃 |
自由 SQL | Gemini 反馈中的 | 不加入 |
行数上限 1000 | Gemini 反馈 | 不适用。保持 200 |
相关
robo-meta-api—POST /meta/catalogK-AIR-metadata-platform— Servingt2s_*K-AIR-Portal— 后续正本入口POST /api/v1/mcp,密钥台账
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.4137 PyPIMIT