mcp-rethinkdb

The MCP RethinkDB Server exposes a set of MCP tools that let clients query and manage data in a RethinkDB instance. It provides nine actions you can invoke via MCP requests: list_databases to enumerate databases, list_tables to list tables within a database, query_table for filtered and ordered reads with optional limits, table_info to fetch metadata like primary keys and indexes, write_data to insert/update/upsert or delete documents, aggregate for counts and aggregations, advanced_query for operations like eq_join and contains, schema_inspector to infer field types and relationships from samples, and index_info to inspect secondary index details. When running via the Docker image, you can connect to a RethinkDB instance by configuring environment variables (RETHINKDB_HOST, RETHINKDB_PORT, and optional username/password) and then issue MCP requests to the server name you configured (default here is rethinkdb). The server is designed to work with Claude Desktop and other MCP clients, enabling AI-assisted data exploration and manipulation against your RethinkDB data.

Prerequisites: • Go 1.23+ for building from source (optional if using Docker) • RethinkDB instance running (default host: localhost, port: 28015) • MCP client for testing (optional)

Option A – Using Docker (recommended):

1. Ensure Docker is installed and running.
2. Pull and run the pre-built image:

docker pull finn13/mcp-rethinkdb-server

3. Run with default settings (connects to localhost:28015):

docker run -e RETHINKDB_HOST=localhost -e RETHINKDB_PORT=28015 finn13/mcp-rethinkdb-server

4. To override host/port and enable authentication, set environment variables as needed (example shown in README):

docker run \
  -e RETHINKDB_HOST=your-host \
  -e RETHINKDB_PORT=28015 \
  -e RETHINKDB_USER=admin \
  -e RETHINKDB_PASSWORD=secret \
  finn13/mcp-rethinkdb-server

Option B – Build from Source: (if you prefer compiling locally)

1. Clone the repository and navigate into it:

git clone https://github.com/finn13/mcp-rethinkdb-server.git
cd mcp-rethinkdb-server

2. Install dependencies and build:

# tidy dependencies
Go mod tidy
# build binary
go build -o mcp-rethinkdb-server .

3. Run the binary with optional environment config for RethinkDB:

RETHINKDB_HOST=localhost RETHINKDB_PORT=28015 ./mcp-rethinkdb-server

Tips and notes: • The Docker image exposes RethinkDB connection via environment variables; adjust RETHINKDB_HOST/RETHINKDB_PORT to match your environment. • If you enable authentication on RethinkDB, pass RETHINKDB_USER and RETHINKDB_PASSWORD accordingly. • Claude Desktop and other MCP clients will expect a JSON config with an mcpServers section; keep host/port values consistent across tools. • If you modify connection details, restart your MCP client to reload the server configuration. • For debugging, confirm that RethinkDB is reachable from the machine running the MCP server (check firewall rules and network settings).