📖 简介

open-db-mcp 是一个基于 Model Context Protocol (MCP) 的多数据源数据库工具，通过 stdio 本地进程与 Claude Desktop / Cursor / Trae 等 AI 客户端即插即用，向 LLM Agent 暴露受限且安全的查询与写入能力。

💡 零网络依赖 · 三层安全护栏 · 一键切换数据源 · 开箱即用

✨ 核心特性

🗄️ 支持的数据库

🚀 快速开始

📥 安装

git clone https://github.com/cjp1016/open-db-mcp.git
cd open-db-mcp
uv sync                  # 或 pip install -e '.[dev]'
uv run open-db-mcp init # 生成 ~/.open-db-mcp/ 配置目录
uv run open-db-mcp doctor  # 健康检查

⚙️ 配置数据源

编辑 ~/.open-db-mcp/datasources.json：

{
  "LOCAL_MYSQL": {
    "driver": "com.mysql.cj.jdbc.Driver",
    "url": "jdbc:mysql://127.0.0.1:3306/test_db?characterEncoding=utf8mb4",
    "user": "root",
    "password": "env:DB_PASSWORD",
    "pool_min": 2,
    "pool_max": 4
  }
}

🔐 密码支持 env: / keyring: / cmd: 四种安全引用方式。

🔗 注册到 MCP 客户端

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "smart-db": {
      "command": "open-db-mcp",
      "args": ["run"],
      "env": {
        "MCP_DATASOURCES_CFG_PATH": "/path/to/your/datasources.json"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）：同上结构。

🛠️ CLI 命令

🧰 MCP 工具清单（25 个）

🏗️ 架构

MCP 工具层（tools/）  →  服务层（services/）  →  驱动层（drivers/）
    薄包装 + 参数解析        业务逻辑 + 校验         DB 方言适配

• ✅ 遵循 SOLID 原则，高内聚低耦合
• ✅ 驱动层基于 Protocol 抽象，易于扩展新数据库
• ✅ 服务层纯业务逻辑，可独立单元测试

👨‍💻 开发

# 代码检查
ruff check src/
mypy src/

💬 联系我们

扫码添加微信，备注 open-db-mcp 加入交流群：

❤️ 支持赞助

如果这个项目对你有帮助，欢迎扫码请作者喝杯咖啡 ☕

📄 License

MIT © open-db-mcp contributors