mcp-db-server
基于 Spring AI MCP Server 的通用数据库 MCP 服务。——数据库连接信息由 AI 客户端在每次调用时传入,服务端不存储任何连接配置或数据。
Potencia tu agente
Instalación del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
Aún no hay una versión empaquetada en el registro. Sigue el README del repositorio.
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en 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.
Abrir支持 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,连接参数即传即用,零持久化零配置。
Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
MCP Db Server se ejecuta localmente por stdio.
Última comprobación: 2026-10-28. 🔥 让 AI 直接操刀你的数据库!无状态 MCP 数据库服务,支持 MySQL / PostgreSQL / SQLite / SQL Server / Oracle / H2,连接参数即传即用,零持久化零配置。