db-mcp-server 项目说明
概述
db-mcp-server 是一个基于 Java 11 + Spring Boot 2.7.18 构建的 MCP(Model Context Protocol)数据库网关,通过标准化工具接口让 AI(Claude)安全访问 MySQL 和 TDengine 数据库,当前同时支持:
stdio MCPHTTP MCPHTTP + SSE MCP
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
db-mcp-server 是一个基于 Java 11 + Spring Boot 2.7.18 构建的 MCP(Model Context Protocol)数据库网关,通过标准化工具接口让 AI(Claude)安全访问 MySQL 和 TDengine 数据库,当前同时支持:
stdio MCPHTTP MCPHTTP + SSE MCPmysql tdengin 数据库 mcpserver
/api/* 调试接口每个业务项目独立启动一个 JVM 进程,绑定自己的数据库,互不干扰:
项目A的Claude窗口 → 独立JVM → 数据库1、数据库2
项目B的Claude窗口 → 独立JVM → 数据库3
java -Xms32m -Xmx128m -XX:TieredStopAtLevel=1 \
-jar db-mcp-server.jar \
--config /path/to/your-project.yml
配置文件模板见 example-config.yml。 如果想直接复制最小可用版本,也可以用:
常用最小配置建议:
stdio-only:mcp.stdio.enabled=true、mcp.http.enabled=false、http.enabled=falsehttp+sse:mcp.stdio.enabled=false、mcp.http.enabled=true,并显式设置 mcp.http.path / mcp.http.ssePath{
"mcpServers": {
"my-project-db": {
"command": "java",
"args": [
"-Xms32m", "-Xmx128m", "-XX:TieredStopAtLevel=1",
"-jar", "/path/to/db-mcp-server.jar",
"--config", "/path/to/my-project.yml"
]
}
}
}
说明:
POST /mcp、GET /mcp/sse)+ 2 个 HTTP 健康端点(/health、/ready)。tools/list 中暴露的 11 个工具,不把 HTTP 传输端点和健康端点计入工具数。启动后自动在 http://127.0.0.1:<随机端口> 监听,实际端口在启动日志中打印。与 MCP 工具语义完全一致,用于开发期本地验证。
GET /health # 进程存活检查(始终 200)
GET /ready # 就绪检查(所有数据源 UP 才返回 200,否则 503)
GET /api/status # getServiceStatus
GET /api/datasources # listDatasources
GET /api/locate-table?tableName= # locateTable
GET /api/tables?datasourceName= # listTables
GET /api/indexes-and-views?datasourceName=
GET /api/describe?datasourceName=&objectName=&objectType=
POST /api/query {"datasourceName": "", "sql": ""}
POST /api/write {"datasourceName": "", "sql": ""}
POST /api/create-table {"datasourceName": "", "sql": ""}
POST /api/explain {"datasourceName": "", "sql": ""}
POST /api/refresh-metadata {"datasourceNames": [], "mode": "SYNC"}
除 stdio 外,当前也支持 MCP over HTTP:
POST /mcp # MCP JSON-RPC 请求入口(initialize / tools/list / tools/call)
GET /mcp/sse # SSE 事件流通道,返回 session 事件与后续服务端通知
当前第一阶段行为:
tools/call 仍通过 POST /mcp 同步返回结果GET /mcp/sse 先提供会话与事件通道能力mcp.http.path / mcp.http.ssePath 已生效,可改为自定义 MCP HTTP / SSE 路径/api/* 继续保留为调试接口,不承载 MCP 协议可选的第二阶段异步模式:
GET /mcp/sse 获取 sessionIdPOST /mcp 时带 X-Mcp-Session-Idtools/call.params 中传 async=true 时,请求会立即返回受理结果tool_progress / tool_result 事件回传示例配置:
mcp:
http:
enabled: true
path: /custom-mcp
ssePath: /custom-mcp/events
如果只想跑 HTTP + SSE,不想保留 stdio,建议同时配置:
mcp:
stdio:
enabled: false
http:
enabled: true
path: /custom-mcp
ssePath: /custom-mcp/events
http:
enabled: true
所有接口(MCP 和 HTTP)返回相同结构:
{
"success": true,
"code": "SUCCESS",
"message": "Returned 42 row(s).",
"data": { ... },
"costMs": 18
}
错误码分组:
常用错误码速查表:
DROP / TRUNCATE / ALTER / GRANT / REVOKELOCK TABLES / UNLOCK TABLES / FLUSH / SET GLOBAL / SHUTDOWNINSERT ... SELECT / CREATE TABLE ... AS SELECTUPDATE / DELETE 没有 WHERE 条件WHERE 1=1 / WHERE TRUE / WHERE 1='1' / WHERE col IS NOT NULLJOIN(TDengine 对通用 JOIN 支持有限)单次 INSERT 行数超过 batchInsertMaxRows(默认 1000)时拒绝执行,并在响应中说明上限和拆批建议。
DATASOURCE_PERMISSION_DENIED,消息中包含完整 GRANT 修复命令,而非通用的 SQL_EXECUTE_ERROR。stdio MCP 模式下,stdout 仅输出 MCP JSON-RPC 协议消息,所有日志(包括审计)写入 stderr,不污染 MCP 通道。mcp.exitOnDisconnect=true 时,Claude Desktop 关闭连接后 JVM 自动退出,无孤儿进程。┌─────────────────────────────────────────────────────┐
│ Transport │
│ McpStdioServer — JSON-RPC 2.0 over stdio │
│ McpTransportController — MCP over HTTP + SSE │
│ McpHttpController — HTTP REST (127.0.0.1) │
│ HealthController — /health /ready │
├─────────────────────────────────────────────────────┤
│ Application │
│ metadata/ execution/ cache/ status/ │
├─────────────────────────────────────────────────────┤
│ Domain │
│ SqlGuard — SQL 安全链(注释清洗→解析→规则) │
│ HealthService — 定时探测 + 调用前快速校验 │
│ MetadataCache — Caffeine 本地缓存 │
│ AuditLogger — 结构化审计(SLF4J logger=audit) │
├─────────────────────────────────────────────────────┤
│ Adapter SPI │
│ DatasourceAdapter / MetadataAdapter │
│ QueryExecutor / WriteExecutor │
│ SqlGuardDialectSupport │
├─────────────────────────────────────────────────────┤
│ Adapter Impl │
│ mysql/ — MySqlAdapter(HikariCP + JDBC) │
│ tdengine/ — TDengineAdapter(RESTful 驱动) │
├─────────────────────────────────────────────────────┤
│ Infrastructure │
│ DataSourceManager / HikariCP │
│ AppConfig (YAML) / HttpPortLogger │
└─────────────────────────────────────────────────────┘
每次工具调用自动写入独立 SLF4J logger audit(INFO 级别),格式为 JSON 单行:
{"timestamp":"2026-04-18T10:00:00.000+0800","tool":"executeQuery","datasource":"user_db","sql":"SELECT * FROM users LIMIT 10","success":true,"durationMs":42,"errorCode":null,"errorMsg":null}
通过 logback 配置可将 audit logger 路由到独立文件或 ELK:
<logger name="audit" level="INFO" additivity="false">
<appender-ref ref="AUDIT_FILE"/>
</logger>
locateTable 返回所有命中的数据源:
{
"matchStatus": "EXACT_MULTI",
"matchedDatasources": [
{"datasourceName": "user_db", "tableName": "orders"},
{"datasourceName": "order_db", "tableName": "orders"}
]
}
AI 或用户根据业务语义选择目标数据源后,后续请求显式传入 datasourceName。
mysql tdengin 数据库 mcpserver
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Db stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। mysql tdengin 数据库 mcpserver