Repository files navigation

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

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

• 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

Download the latest release for your platform fromGitHub Releases:

Installation Steps:

Windows:

1. Downloadrbdc-mcp-windows-x86_64.exe
2. Rename torbdc-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"
   • AddC:\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-mcpchmod +x rbdc-mcpsudo mv rbdc-mcp /usr/local/bin/

3. Test:rbdc-mcp --help

Linux:

1. Downloadrbdc-mcp-linux-x86_64
2. Rename and install:

   mv rbdc-mcp-linux-x86_64 rbdc-mcpchmod +x rbdc-mcpsudo mv rbdc-mcp /usr/local/bin/

3. Test:rbdc-mcp --help

Prerequisites: InstallRust first.

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

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

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

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

In Claude Desktop, try asking:

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

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

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

Step 1: Configuration

Step 2: Usage in Claude

Apache-2.0