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
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。
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Db ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 mysql tdengin 数据库 mcpserver