RBDC MCP Server

基于模型上下文协议（MCP）的数据库服务器，支持SQLite、MySQL、PostgreSQL和MSSQL数据库。

🇨🇳 中文文档 / Chinese Documentation: README_cn.md

优势

• 多数据库支持：通过统一接口无缝处理SQLite、MySQL、PostgreSQL和MSSQL
• AI集成：通过模型上下文协议原生集成Claude AI
• 零配置：自动管理数据库连接和资源
• 安全性：通过AI驱动的自然语言查询控制对数据库的访问
• 简易性：使用自然语言查询和修改数据库，无需编写SQL

安装

🚀 方法1：下载预编译二进制文件（推荐）

从GitHub Releases下载适用于您平台的最新版本：

平台	下载
Windows (x64)	rbdc-mcp-windows-x86_64.exe
macOS (Intel)	rbdc-mcp-macos-x86_64
macOS (Apple Silicon)	rbdc-mcp-macos-aarch64
Linux (x64)	rbdc-mcp-linux-x86_64

安装步骤：

Windows:

1. 下载 (rbdc-mcp-windows-x86_64.exe)[https://github.com/rbatis/rbdc-mcp/releases]
2. 重命名为 rbdc-mcp.exe
3. 移动到目录，例如 C:\tools\rbdc-mcp.exe
4. 添加到PATH环境变量：
   • 右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”
   • 在“系统变量”中找到“Path”，点击“编辑”
   • 将 C:\tools 添加到路径列表中
5. 重启命令提示符，测试：rbdc-mcp --help

macOS:

1. 下载合适的文件：
   • Intel芯片： (rbdc-mcp-macos-x86_64)[https://github.com/rbatis/rbdc-mcp/releases]
   • Apple Silicon： (rbdc-mcp-macos-aarch64)[https://github.com/rbatis/rbdc-mcp/releases]
2. 重命名并安装：

   mv rbdc-mcp-macos-* rbdc-mcp
   chmod +x rbdc-mcp
   sudo mv rbdc-mcp /usr/local/bin/
   

3. 测试：rbdc-mcp --help

Linux:

1. 下载 rbdc-mcp-linux-x86_64
2. 重命名并安装：

   mv rbdc-mcp-linux-x86_64 rbdc-mcp
   chmod +x rbdc-mcp
   sudo mv rbdc-mcp /usr/local/bin/
   

3. 测试：rbdc-mcp --help

🛠️ 方法2：通过Cargo安装

前提条件：首先安装Rust。

cargo install --git https://github.com/rbatis/rbdc-mcp.git

🔧 方法3：从源代码构建

git clone https://github.com/rbatis/rbdc-mcp.git
cd rbdc-mcp
cargo build --release
# 可执行文件：target/release/rbdc-mcp

🔧 快速设置

第一步：配置Claude桌面

配置文件位置：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

基本配置：

{
  "mcpServers": {
    "rbdc-mcp": {
      "command": "rbdc-mcp",
      "args": ["--database-url", "sqlite://./database.db"]
    }
  }
}

特定平台示例：

<details> <summary><strong>不同数据库示例</strong></summary>

{
  "mcpServers": {
    "rbdc-mcp-sqlite": {
      "command": "rbdc-mcp",
      "args": ["--database-url", "sqlite://./database.db"]
    },
    "rbdc-mcp-mysql": {
      "command": "rbdc-mcp",
      "args": ["--database-url", "mysql://user:password@localhost:3306/database"]
    },
    "rbdc-mcp-postgres": {
      "command": "rbdc-mcp",
      "args": ["--database-url", "postgres://user:password@localhost:5432/database"]
    }
  }
}

</details> <details> <summary><strong>Windows完整路径（如果不在PATH中）</strong></summary>

{
  "mcpServers": {
    "rbdc-mcp": {
      "command": "C:\\tools\\rbdc-mcp.exe",
      "args": ["--database-url", "sqlite://C:\\path\\to\\database.db"]
    }
  }
}

</details>

第二步：重启Claude桌面

保存配置后，重启Claude桌面以加载MCP服务器。

第三步：测试连接

在Claude桌面中尝试询问：

• "显示我的数据库连接状态"
• "我的数据库中有哪些表？"

📊 使用示例

自然语言数据库操作

• 查询数据："显示数据库中的所有用户"
• 修改数据："添加一个名为John的新用户，电子邮件为john@example.com"
• 获取状态："数据库连接状态是什么？"
• 模式信息："我的数据库中有哪些表？"

🗄️ 数据库支持

数据库	连接URL格式
SQLite	sqlite://path/to/database.db
MySQL	mysql://user:password@host:port/database
PostgreSQL	postgres://user:password@host:port/database
MSSQL	mssql://user:password@host:port/database

⚙️ 配置选项

参数	描述	默认值
--database-url, -d	数据库连接URL	必需
--max-connections	最大连接池大小	1
--timeout	连接超时（秒）	30
--log-level	日志级别（error/warn/info/debug）	info

🛠️ 可用工具

• sql_query：安全地执行SELECT查询
• sql_exec：执行INSERT/UPDATE/DELETE操作
• db_status：检查连接池状态

📸 截图

第一步：配置

第二步：在Claude中的使用

许可证

Apache-2.0