What is DB MCP Server?

基本能力

产品定位

DB MCP Server 是一个多数据库中间件，通过标准化接口为 AI 助手提供数据库操作能力，支持 MySQL 和 PostgreSQL 等多种数据库。

核心功能

• 多数据库并发支持：同时连接和操作多个数据库
• 动态工具生成：为每个数据库自动生成专用工具（查询、执行、事务、模式、性能分析）
• 统一接口：跨数据库类型的一致交互模式
• 事务管理：支持跨会话的事务操作
• 架构清晰：采用 Clean Architecture 设计

适用场景

• AI 助手需要访问多个数据库的场景
• 需要统一管理不同数据库的开发环境
• 数据库查询和分析自动化

工具列表

1. query_：执行 SQL 查询
2. execute_：执行数据修改语句
3. transaction_：管理事务
4. schema_：探索数据库模式
5. performance_：分析查询性能
6. list_databases：列出所有配置的数据库连接

常见问题解答

1. 连接错误：检查 config.json 中的数据库连接设置
2. 工具未找到：确保服务器运行并检查工具名称前缀
3. 查询失败：检查 SQL 语法和数据库权限
4. Docker 挂载错误：避免覆盖容器内的默认配置文件路径

使用教程

使用依赖

• Docker（推荐）或 Go 环境（从源码构建）

安装教程

Docker 方式

docker pull freepeak/db-mcp-server:latest
docker run -p 9092:9092 \
  -v $(pwd)/config.json:/app/my-config.json \
  -e TRANSPORT_MODE=sse \
  -e CONFIG_PATH=/app/my-config.json \
  freepeak/db-mcp-server

源码方式

git clone https://github.com/FreePeak/db-mcp-server.git
cd db-mcp-server
make build
./server -t sse -c config.json

调试方式

# 启用调试日志
./server -t sse -debug -c config.json

# 查看日志位置
- STDIO 模式：stderr
- SSE 模式：stdout 和 ./logs/db-mcp-server.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。