https://github.com/rbatis/rbdc-mcp
rbdc-mcp-server
https://github.com/rbatis/rbdc-mcp
Last synced: about 1 month ago
JSON representation
rbdc-mcp-server
- Host: GitHub
- URL: https://github.com/rbatis/rbdc-mcp
- Owner: rbatis
- Created: 2025-06-21T14:49:48.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-21T16:27:08.000Z (5 months ago)
- Last Synced: 2025-06-21T16:34:22.369Z (5 months ago)
- Language: Rust
- Size: 854 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **rbdc-mcp** - rbdc-mcp-server (Rust-based) `rust` `mcp` `server` `cargo install --git https://github.com/rbatis/rbdc-mcp` (π§ Utilities)
README
# RBDC MCP Server
A database server based on [Model Context Protocol (MCP)](https://modelcontextprotocol.io), supporting SQLite, MySQL, PostgreSQL, and MSSQL databases.
**π¨π³ δΈζζζ‘£ / Chinese Documentation**: [README_cn.md](./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](https://github.com/rbatis/rbdc-mcp/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`)[https://github.com/rbatis/rbdc-mcp/releases]
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`)[https://github.com/rbatis/rbdc-mcp/releases]
- Apple Silicon: (`rbdc-mcp-macos-aarch64`)[https://github.com/rbatis/rbdc-mcp/releases]
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:**
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](https://rustup.rs/) first.
```bash
cargo install --git https://github.com/rbatis/rbdc-mcp.git
```
### π§ Method 3: Build from Source
```bash
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:**
```json
{
"mcpServers": {
"rbdc-mcp": {
"command": "rbdc-mcp",
"args": ["--database-url", "sqlite://./database.db"]
}
}
}
```
**Platform-Specific Examples:**
Different Database Examples
```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 Full Path (if not in PATH)
```json
{
"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