RBDC MCP Server

A database server based on Model Context Protocol (MCP), supporting SQLite, MySQL, PostgreSQL, and MSSQL databases.

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

Advantages

• Multiple Database Support: Seamlessly work with SQLite, MySQL, PostgreSQL, and MSSQL using a unified interface
• AI Integration: Native integration with Claude AI through the Model Context Protocol
• Zero Configuration: Automatic management of database connections and resources
• Security: Controlled access to your database through AI-driven natural language queries
• Simplicity: Use natural language to query and modify your database without writing SQL

Installation

🚀 Method 1: Download Pre-built Binaries (Recommended)

Download the latest release for your platform from GitHub Releases:

Platform	Download
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

Installation Steps:

Windows:

1. Download rbdc-mcp-windows-x86_64.exe
2. Rename to rbdc-mcp.exe
3. Move to a directory, e.g., C:\tools\rbdc-mcp.exe
4. Add to PATH environment variable:
   • Right-click "This PC" → "Properties" → "Advanced system settings" → "Environment Variables"
   • Find "Path" in "System variables", click "Edit"
   • Add C:\tools to the path list
5. Restart command prompt, test: rbdc-mcp --help

macOS:

1. Download the appropriate file:
   • Intel chip: rbdc-mcp-macos-x86_64
   • Apple Silicon: rbdc-mcp-macos-aarch64
2. Rename and install:

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

3. Test: rbdc-mcp --help

Linux:

1. Download rbdc-mcp-linux-x86_64
2. Rename and install:

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

3. Test: rbdc-mcp --help

🛠️ Method 2: Install via Cargo

Prerequisites: Install Rust first.

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

🔧 Method 3: Build from Source

git clone https://github.com/rbatis/rbdc-mcp.git
cd rbdc-mcp
cargo build --release
# Executable: target/release/rbdc-mcp

🔧 Quick Setup

Step 1: Configure Claude Desktop

Configuration File Location:

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

Basic Configuration:

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

Platform-Specific Examples:

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

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

Step 2: Restart Claude Desktop

After saving the configuration, restart Claude Desktop to load the MCP server.

Step 3: Test the Connection

In Claude Desktop, try asking:

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

📊 Usage Examples

Natural Language Database Operations

• Query Data: "Show me all users in the database"
• Modify Data: "Add a new user named John with email john@example.com"
• Get Status: "What's the database connection status?"
• Schema Info: "What tables exist in my database?"

🗄️ Database Support

Database	Connection URL Format
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

⚙️ Configuration Options

Parameter	Description	Default
--database-url, -d	Database connection URL	Required
--max-connections	Maximum connection pool size	1
--timeout	Connection timeout (seconds)	30
--log-level	Log level (error/warn/info/debug)	info

🛠️ Available Tools

• sql_query: Execute SELECT queries safely
• sql_exec: Execute INSERT/UPDATE/DELETE operations
• db_status: Check connection pool status

📸 Screenshots

Step 1: Configuration

Step 2: Usage in Claude

License

Apache-2.0