You run the RBDC MCP Server to access and manage your databases through natural language queries via the Model Context Protocol. It supports SQLite, MySQL, PostgreSQL, and MSSQL, letting you work with data without writing SQL while keeping security and resource management under control.

How to use

You interact with the MCP server through an MCP client. Start the MCP server locally, connect your client to it, and then issue natural language requests to query, insert, update, or structure your data. You can check the database status, inspect tables, and perform common data operations using plain language. When you configure the client, point it at the MCP command you run on your machine, and provide the database URL you want to connect to.

How to install

Prerequisites: you need a Rust toolchain installed to build from source or use the provided binaries. You should also have a terminal or command prompt available.

Method 1: Download Pre-built Binaries (Recommended) — choose the appropriate binary for your platform and follow the installation steps.

Windows

1. Download the Windows binary for x64
2. Rename to rbdc-mcp.exe
3. Move to a directory, e.g., C:\tools\rbdc-mcp.exe
4. Add the directory to PATH
5. Open a new terminal and test: rbdc-mcp --help

macOS (Intel)

1. Download rbdc-mcp-macos-x86_64
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

macOS (Apple Silicon)
1. Download rbdc-mcp-macos-aarch64
2. Rename and install:
```bash
mv rbdc-mcp-macos-* rbdc-mcp
chmod +x rbdc-mcp
sudo mv rbdc-mcp /usr/local/bin/```
3. Test: rbdc-mcp --help

Linux (x64)
1. Download rbdc-mcp-linux-x86\_64
2. Rename and install:
```bash
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 using the MCP server you run locally. You will point Claude to the local MCP instance and set the database URL to the one you want to connect to.

Step 2 Restart Claude Desktop to load the MCP server configuration.

Step 3 Test the connection by asking Claude to show the database connection status or list tables.

## Configuration example for Claude Desktop

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

## Usage examples in natural language

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

This MCP server supports multiple database backends via a unified interface, including SQLite for lightweight, file-based storage.

## Notes on configuration

The standard MCP command uses the database URL to establish a connection. You can run with different URLs to connect to MySQL, PostgreSQL, or MSSQL databases by updating the --database-url parameter accordingly.

## Security and access

Access to the database is controlled by the MCP server configuration and the authentication mechanism of your MCP client. Ensure you use strong credentials and limit access to trusted clients.

## Troubleshooting

If you encounter connection issues, verify that the MCP server process is running, the database URL is reachable, and the network path between the client and server is open. Check the MCP client logs for error messages related to authentication or connection pooling.

## Screenshots

Step 1: Configuration Step 2: Usage in Claude

## License

Apache-2.0

## Available tools

### sql\_query

Execute SELECT queries safely

### sql\_exec

Execute INSERT/UPDATE/DELETE operations

### db\_status

Check connection pool status