mcp-db-server
基于 Spring AI MCP Server 的通用数据库 MCP 服务。完全无状态——数据库连接信息由 AI 客户端在每次调用时传入,服务端不存储任何连接配置或数据。
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
支持 MySQL、PostgreSQL、H2、SQLite、SQL Server、Oracle 六大数据库。
┌──────────────┐ 连接参数(每调) ┌──────────────────┐ JDBC ┌────────────┐
│ AI 客户端 │ ──────────────────▶ │ mcp-db-server │ ───────────▶ │ 数据库 │
│ (Claude等) │ ◀────────────────── │ (无状态服务) │ ◀─────────── │ (MySQL等) │
└──────────────┘ 查询结果 └──────────────────┘ └────────────┘
type、host、port、database、username、password 作为参数传入# Windows (PowerShell)
.\mvnw.cmd spring-boot:run
# Linux / macOS
./mvnw spring-boot:run
服务启动后,MCP SSE 端点为 http://localhost:8088/sse。
# 构建镜像
docker build -t mcp-db-server .
# 运行容器
docker run -d -p 8088:8088 --name mcp-db-server mcp-db-server
./mvnw clean package -DskipTests
java -jar target/mcp-db-server-1.0.0.jar
每个工具都需要 AI 客户端传入完整的数据库连接参数。
当 AI 客户端需要列出本地 MySQL 数据库的表时,它会调用:
Tool: listTables
type = "mysql"
host = "localhost"
port = 3306
database = "mydb"
username = "root"
password = "****"
{
"mcpServers": {
"mcp-db-server": {
"type": "sse",
"url": "http://localhost:8088/sse"
}
}
}
{
"mcpServers": {
"mcp-db-server": {
"transport": "sse",
"url": "http://localhost:8088/sse"
}
}
}
在 Trae 的 MCP 设置中添加:
{
"mcpServers": {
"mcp-db-server": {
"transport": "sse",
"url": "http://localhost:8088/sse"
}
}
}
注意:不同客户端使用的 SSE 端点路径可能不同。本项目配置的 SSE 端点为
/sse,所有客户端统一使用http://localhost:8088/sse连接。
mcp-db-server/
├── src/main/java/com/mcp/db/
│ ├── McpDbServerApplication.java # 启动类
│ ├── config/
│ │ └── ConnectionFactory.java # 动态连接工厂(含连接池缓存)
│ └── tool/
│ └── DatabaseTools.java # MCP 工具方法(@Tool 注解)
├── src/main/resources/
│ └── application.yml # 应用配置(仅服务端口和 MCP 设置)
├── sql/init/
│ └── 01-init-demo.sql # MySQL 示例初始化数据
├── Dockerfile # Docker 镜像构建
├── docker-compose.yml # 一键部署(含 MySQL 示例)
├── .env.example # 环境变量模板
├── pom.xml # Maven 依赖管理
└── LICENSE
推荐使用 IntelliJ IDEA。
# 编译
./mvnw compile
# 运行测试
./mvnw test
# 打包
./mvnw clean package -DskipTests
ConnectionFactory.java 中:
DEFAULT_PORTS 添加默认端口映射DRIVER_CLASSES 添加 JDBC 驱动类映射buildJdbcUrl() 添加 JDBC URL 构建逻辑pom.xml 中添加对应的 JDBC 驱动依赖欢迎提交 PR!
请参阅 CONTRIBUTING.md 了解如何参与贡献。
本项目基于 MIT License 开源。
🔥 让 AI 直接操刀你的数据库!无状态 MCP 数据库服务,支持 MySQL / PostgreSQL / SQLite / SQL Server / Oracle / H2,连接参数即传即用,零持久化零配置。
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
MCP Db Server 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 🔥 让 AI 直接操刀你的数据库!无状态 MCP 数据库服务,支持 MySQL / PostgreSQL / SQLite / SQL Server / Oracle / H2,连接参数即传即用,零持久化零配置。