金大哥 - rbdc-mcp MCP 详情

article

README

🚀 RBDC MCP Server

RBDC MCP Server 是一个基于 Model Context Protocol (MCP) 的数据库服务器，支持 SQLite、MySQL、PostgreSQL 和 MSSQL 数据库。它提供了统一的接口，让用户可以无缝地与多种数据库进行交互，同时还能与 Claude AI 进行原生集成。

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

✨ 主要特性

多数据库支持：通过统一接口无缝支持 SQLite、MySQL、PostgreSQL 和 MSSQL 数据库。
AI 集成：通过 Model Context Protocol 与 Claude AI 进行原生集成。
零配置：自动管理数据库连接和资源。
安全性：通过 AI 驱动的自然语言查询来控制对数据库的访问。
简单易用：无需编写 SQL，使用自然语言即可查询和修改数据库。

📦 安装指南

🚀 方法一：下载预构建二进制文件（推荐）

从 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：

下载 rbdc-mcp-windows-x86_64.exe。
重命名为 rbdc-mcp.exe。
移动到指定目录，例如 C:\tools\rbdc-mcp.exe。
添加到 PATH 环境变量：
- 右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”。
- 在“系统变量”中找到“Path”，点击“编辑”。
- 将 C:\tools 添加到路径列表中。
重启命令提示符，测试：rbdc-mcp --help。

macOS：

下载合适的文件：
- Intel 芯片：rbdc-mcp-macos-x86_64。
- Apple Silicon：rbdc-mcp-macos-aarch64。
重命名并安装：

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

测试：rbdc-mcp --help。

Linux：

下载 rbdc-mcp-linux-x86_64。
重命名并安装：

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

测试：rbdc-mcp --help。

🛠️ 方法二：通过 Cargo 安装

前提条件： 首先安装 Rust。

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

🔧 方法三：从源代码构建

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

🚀 快速开始

步骤一：配置 Claude Desktop

配置文件位置：

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"]
    }
  }
}

特定平台示例：

不同数据库示例

```json { "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"] } } } ```

Windows 全路径（若不在 PATH 中）

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

步骤二：重启 Claude Desktop

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

步骤三：测试连接

在 Claude Desktop 中尝试询问：

"Show me the database connection status"
"What tables are in my database?"

💻 使用示例

自然语言数据库操作

查询数据："Show me all users in the database"
修改数据："Add a new user named John with email john@example.com"
获取状态："What's the database connection status?"
获取架构信息："What tables exist in my database?"

🗄️ 数据库支持

| 数据库 | 连接 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 许可证。

rbdc-mcp