AI导哈

数据库查询写入服务

基于Spring Boot的MCP服务器，为AI客户端提供达梦数据库的查询和写入能力。

  • by zjm5-la
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 latestzjm5s-tech/dameng-mcp-server

使用说明

达梦数据库 MCP Server

基于 Spring Boot 的 MCP (Model Context Protocol) 服务器，为 AI 客户端提供达梦数据库的查询和写入能力。

功能特性

  • 通过 SSE (Server-Sent Events) 协议暴露 MCP 工具
  • 支持只读查询（SELECT）和写入操作（INSERT/UPDATE/DELETE/CREATE/DROP/ALTER/TRUNCATE）
  • SSE 心跳保活机制，防止长时间空闲连接断开
  • 查询结果限制 1000 行，防止内存溢出
  • 支持 ARM64 Mac (Apple Silicon) Docker 环境运行

MCP 工具

工具名 描述
executeQuery 执行只读 SELECT 查询（最多返回 1000 行）
executeMutation 执行 DML/DDL 操作（INSERT/UPDATE/DELETE/CREATE/DROP/ALTER/TRUNCATE）

环境要求

  • Java 17+
  • 达梦数据库

快速开始

编译

注意：需要 Java 17+ 环境，请确保 JAVA_HOME 指向正确的 JDK 版本。

# 检查 Java 版本
java -version

# 编译项目
./mvnw clean package -DskipTests

运行

Linux / macOS：

# 使用环境变量配置数据库连接
export DB_URL=jdbc:dm://localhost:5236/DAMENG
export DB_USERNAME=SYSDBA
export DB_PASSWORD=yourpassword

./mvnw spring-boot:run

Windows (CMD)：

set DB_URL=jdbc:dm://localhost:5236/DAMENG
set DB_USERNAME=SYSDBA
set DB_PASSWORD=yourpassword

mvnw.cmd spring-boot:run

Windows (PowerShell)：

$env:DB_URL="jdbc:dm://localhost:5236/DAMENG"
$env:DB_USERNAME="SYSDBA"
$env:DB_PASSWORD="yourpassword"

.\mvnw.cmd spring-boot:run

Docker 部署

亮点：基于 amazoncorretto:17-alpine 镜像，原生支持 ARM64 架构，可在 Apple Silicon Mac (M1/M2/M3/M4) 上流畅运行。

# 构建镜像
docker build -t dameng-mcp-server .

# 运行容器
docker run -d -p 8080:8080 \
  -e DB_URL=jdbc:dm://host:5236/DAMENG \
  -e DB_USERNAME=SYSDBA \
  -e DB_PASSWORD=yourpassword \
  --name dameng-mcp \
  dameng-mcp-server

Claude Code 配置

服务启动后，在 Claude Code 中添加 MCP 服务：

claude mcp add --transport sse dameng-db http://localhost:8080/sse

添加成功后，Claude Code 即可使用达梦数据库查询工具。

配置说明

数据库连接

环境变量 默认值 说明
DB_URL jdbc:dm://localhost:5236/DAMENG JDBC 连接地址
DB_USERNAME SYSDBA 数据库用户名
DB_PASSWORD SYSDBA 数据库密码

连接策略

  • 每次请求创建新连接（无连接池）
  • 自动添加连接超时参数：connectTimeout=5000&socketTimeout=10000
  • 查询超时：10 秒

SSE 保活机制

  • keep-alive-interval: 30 秒（MCP Server 定期发送心跳）
  • tomcat.keep-alive-timeout: 5 分钟

安全机制

查询工具 (executeQuery)

  • 仅允许 SELECT 查询
  • 禁止 INSERT/UPDATE/DELETE/DROP 操作
  • 禁止 SQL 注释
  • 禁止存储过程调用
  • 查询结果限制 1000 行

写入工具 (executeMutation)

  • 支持 DML 操作：INSERT/UPDATE/DELETE
  • 支持 DDL 操作：CREATE/DROP/ALTER/TRUNCATE
  • 禁止 SQL 注释
  • 禁止存储过程调用

项目结构

com.uniin.ioc.dameng/
├── DamengApplication.java          # 主入口
├── config/
│   └── DatabaseConfig.java         # DataSource 和 JdbcTemplate 配置
├── service/
│   ├── DamengQueryService.java     # SQL 查询执行
│   └── DamengMutationService.java  # SQL 写入执行
├── mcp/
│   └── DamengMcpTools.java         # MCP 工具定义
├── validator/
│   └── SqlValidator.java           # SQL 校验（读/写）
└── exception/
    ├── InvalidSqlException.java
    └── QueryExecutionException.java

许可证

MIT License

相关 MCP