多数据库MCP服务器

一个强大的多数据库服务器，实现了模型上下文协议(MCP)，为AI助手提供结构化访问数据库的能力。

概述 • 核心概念 • 功能特性 • 支持的数据库 • 部署选项 • 配置 • 可用工具 • 示例 • 故障排除 • 贡献

概述

DB MCP服务器为AI模型提供了一种标准化的方式，使其能够同时与多个数据库交互。基于FreePeak/cortex框架构建，它使AI助手能够通过统一的接口执行SQL查询、管理事务、探索模式结构并分析不同数据库系统中的性能。

核心概念

多数据库支持

与传统数据库连接器不同，DB MCP服务器可以同时连接并与多个数据库交互：

{
  "connections": [
    {
      "id": "mysql1",
      "type": "mysql",
      "host": "localhost",
      "port": 3306,
      "name": "db1",
      "user": "user1",
      "password": "password1"
    },
    {
      "id": "postgres1",
      "type": "postgres",
      "host": "localhost",
      "port": 5432,
      "name": "db2",
      "user": "user2",
      "password": "password2"
    }
  ]
}

动态工具生成

对于每个连接的数据库，服务器会自动生成专门的工具：

// 对于ID为"mysql1"的数据库，会生成以下工具：
query_mysql1       // 执行SQL查询
execute_mysql1     // 运行数据修改语句
transaction_mysql1 // 管理事务
schema_mysql1      // 探索数据库模式
performance_mysql1 // 分析查询性能

清晰架构

服务器遵循清晰架构原则，包含以下层次：

1. 领域层：核心业务实体和接口
2. 存储库层：数据访问实现
3. 用例层：应用程序业务逻辑
4. 交付层：外部接口(MCP工具)

功能特性

• 多数据库同时支持：同时连接多个MySQL和PostgreSQL数据库
• 数据库特定工具生成：为每个连接的数据库自动创建专用工具
• 清晰架构：模块化设计，职责清晰分离
• OpenAI Agents SDK兼容性：完全兼容，便于AI助手无缝集成
• 动态数据库工具：执行查询、运行语句、管理事务、探索模式、分析性能
• 统一接口：跨不同数据库类型的一致交互模式
• 连接管理：多数据库连接的简单配置

支持的数据库

部署选项

DB MCP服务器可以通过多种方式部署，以适应不同的环境和集成需求：

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

注意：挂载到/app/my-config.json，因为容器默认文件位于/app/config.json。

STDIO模式(IDE集成)

# 以STDIO模式运行服务器
./bin/server -t stdio -c config.json

对于Cursor IDE集成，添加到.cursor/mcp.json：

{
  "mcpServers": {
    "stdio-db-mcp-server": {
      "command": "/path/to/db-mcp-server/server",
      "args": ["-t", "stdio", "-c", "/path/to/config.json"]
    }
  }
}

SSE模式(服务器发送事件)

# 默认配置(localhost:9092)
./bin/server -t sse -c config.json

# 自定义主机和端口
./bin/server -t sse -host 0.0.0.0 -port 8080 -c config.json

客户端连接端点：http://localhost:9092/sse

源代码安装

# 克隆仓库
git clone https://github.com/FreePeak/db-mcp-server.git
cd db-mcp-server

# 构建服务器
make build

# 运行服务器
./bin/server -t sse -c config.json

配置

数据库配置文件

创建一个config.json文件，包含你的数据库连接信息：

{
  "connections": [
    {
      "id": "mysql1",
      "type": "mysql",
      "host": "mysql1",
      "port": 3306,
      "name": "db1",
      "user": "user1",
      "password": "password1",
      "query_timeout": 60,
      "max_open_conns": 20,
      "max_idle_conns": 5,
      "conn_max_lifetime_seconds": 300,
      "conn_max_idle_time_seconds": 60
    },
    {
      "id": "postgres1",
      "type": "postgres",
      "host": "postgres1",
      "port": 5432,
      "name": "db1",
      "user": "user1",
      "password": "password1"
    }
  ]
}

命令行选项

# 基本语法
./bin/server -t <传输方式> -c <配置文件>

# SSE传输选项
./bin/server -t sse -host <主机名> -port <端口> -c <配置文件>

# 内联数据库配置
./bin/server -t stdio -db-config '{"connections":[...]}'

# 环境变量配置
export DB_CONFIG='{"connections":[...]}'
./bin/server -t stdio

可用工具

对于每个连接的数据库，DB MCP服务器会自动生成这些专用工具：

查询工具

模式工具

性能工具

TimescaleDB工具

对于安装了TimescaleDB扩展的PostgreSQL数据库，还可以使用这些额外的专用工具：

有关TimescaleDB工具的详细文档，请参阅TIMESCALEDB_TOOLS.md。

示例

查询多个数据库

-- 查询第一个数据库
query_mysql1("SELECT * FROM users LIMIT 10")

-- 在同一上下文中查询第二个数据库
query_postgres1("SELECT * FROM products WHERE price > 100")

管理事务

-- 开始事务
transaction_mysql1("BEGIN")

-- 在事务内执行语句
execute_mysql1("INSERT INTO orders (customer_id, product_id) VALUES (1, 2)")
execute_mysql1("UPDATE inventory SET stock = stock - 1 WHERE product_id = 2")

-- 提交或回滚
transaction_mysql1("COMMIT")
-- 或者
transaction_mysql1("ROLLBACK")

探索数据库模式

-- 获取数据库中的所有表
schema_mysql1("tables")

-- 获取特定表的列
schema_mysql1("columns", "users")

-- 获取约束
schema_mysql1("constraints", "orders")

故障排除

常见问题

• 连接失败：验证网络连接和数据库凭据
• 权限错误：确保数据库用户具有适当的权限
• 超时问题：检查配置中的query_timeout设置

日志

启用详细日志以进行故障排除：

./bin/server -t sse -c config.json -v

贡献

我们欢迎对DB MCP服务器项目的贡献！要贡献：

1. 分叉仓库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交更改(git commit -m 'feat: add amazing feature')
4. 推送到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

请参阅我们的CONTRIBUTING.md文件以获取详细指南。

许可证

本项目根据MIT许可证授权 - 详情请参阅LICENSE文件。