DB_MCP_Server
DB_MCP_Server 是一个强大的数据库连接和操作服务，通过 MCP (Model Context Protocol) 协议为 AI 应用提供数据库访问能力。项目采用响应式编程模型（WebFlux），支持多种主流数据库，为 AI Agent 提供安全、高效的数据库操作接口。
Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio kiss-gg-db_mcp_server docker run -i kiss-gg/db-mcp-server:latest \ --env DB_HOST="数据库主机地址" \ --env DB_NAME="数据库名" \ --env DB_PORT="数据库端口" \ --env DB_PASSWORD="数据库密码" \ --env DB_USERNAME="数据库用户名" \ --env SPRING_PROFILES_ACTIVE="default"
How to use
DB MCP Server 提供一个基于 Spring Boot 与 Spring AI 的 MCP 服务，用于通过 MCP 协议访问和操作关系型数据库。服务器暴露 HTTP 流式连接的 /mcp 端点，AI Agent 可以通过 MCP 工具调用来执行查询、写操作、元数据检索等数据库任务，并且支持对写操作进行预览和确认，以提升安全性。该实现具备多数据库驱动、事务支持和元数据查询能力，适合将数据库能力暴露给智能代理进行数据分析、数据检索和自动化操作。要使用它，你需要先运行服务（可通过 Docker 快速启动，或以 Maven/JAR 方式本地运行），然后在你的 MCP 客户端中配置服务器的 mcpServers 条目，将 url 指向 /mcp 流式端点，并设置传输方式为 streamable-http。启动后，可以通过执行 executeQuery、executeWrite、confirmWrite、executeBatch、getMetadata、executeDDL 等工具调用来完成对数据库的常见操作。若你使用 Docker 运营环境，确保数据库可达且网络策略放行相应端口，MCP 也会通过 actuator 提供健康和监控端点。
How to install
prerequisites:
- Docker 或 Java 运行环境（若使用 JAR 手动运行）
- Docker 至少 18.06+ 或 Java 17+与 Maven 3.6+（若本地构建）
- 数据库驱动及数据库服务可达
快速安装步骤（使用 Docker）:
- 拉取并运行容器（示例，实际镜像名请以官方为准）
docker pull kiss-gg/db-mcp-server:latest
docker run -d --name db-mcp-server -p 8888:8888 -e SPRING_PROFILES_ACTIVE=prod kiss-gg/db-mcp-server:latest
- 验证服务健康
curl http://localhost:8888/actuator/health
若要在本地开发环境运行（使用 JAR）：
- 克隆仓库并进入项目目录
git clone https://github.com/KISS-GG/DB_MCP_Server.git
cd DB_MCP_Server
- 构建服务
mvn clean package
- 运行 JAR 包
java -jar target/db-mcp-server-0.0.1.jar
- 验证服务健康
curl http://localhost:8888/actuator/health
更新和配置说明:
- 如需连接具体数据库，需要在应用配置中设置数据源信息（通过环境变量或 application.yml/ properties 配置）。
- 若使用 KingBase 等非常见驱动，请按照 README 提示的方式先在本地 Maven 仓库中安装驱动。
Additional notes
提示与常见问题:
- 若连接超时，请检查网络、数据库服务状态、权限及放行端口，必要时增大 timeout 参数。
- 写操作的 confirmId 有效期默认为 5 分钟，超时后需重新执行 executeWrite 并获取新的 confirmId。
- 支持通过环境变量调整 HikariCP 参数，如最大连接数、空闲连接数和连接超时等： spring: datasource: hikari: maximum-pool-size: 10 minimum-idle: 5 connection-timeout: 30000
- 使用 Docker 运行时，确保数据库连接信息通过环境变量或配置注入到容器内。
- 若需要监控，Spring Actuator 提供 health、mappings、beans、env 等端点，默认端口 8888 以及相关路径。
