DBX MCP Server

Lets an assistant inspect schemas and run SQL, MongoDB and Redis operations on databases set up in DBX.

By t8y2 (individual) Rust Local · stdio Databases

74 popularity score ★ 29k ↓ 9.6k/wk

Connect your client

Local (npm)

Add in one click

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal
claude mcp add dbx -- npx -y @dbx-app/mcp-server
Claude Desktopclaude_desktop_config.json
{
  "mcpServers": {
    "dbx": {
      "command": "npx",
      "args": [
        "-y",
        "@dbx-app/mcp-server"
      ]
    }
  }
}
Cursor~/.cursor/mcp.json
{
  "mcpServers": {
    "dbx": {
      "command": "npx",
      "args": [
        "-y",
        "@dbx-app/mcp-server"
      ]
    }
  }
}
VS Code.vscode/mcp.json
{
  "servers": {
    "dbx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dbx-app/mcp-server"
      ]
    }
  }
}
Codex~/.codex/config.toml
[mcp_servers.dbx]
command = "npx"
args = ["-y", "@dbx-app/mcp-server"]
Gemini CLITerminal
gemini mcp add --scope user dbx npx -- -y @dbx-app/mcp-server

Settings 8

DBX_DATA_DIR Optional: Override the local DBX data directory; needed for Windows portable builds.
DBX_WEB_URL Optional: Use a DBX Web or Docker backend instead of local storage.
DBX_WEB_PASSWORD Optional: Password for the DBX Web backend, when its login page requires one.
DBX_MCP_SCOPE_CONNECTION_NAME Optional: Restrict tools to one connection name.
DBX_MCP_SCOPE_DATABASE Optional: Restrict tools to one database.
DBX_MCP_TRANSPORT Optional: stdio (default) or streamable-http for the native server.
DBX_MCP_HTTP_TOKEN Optional: Bearer token required by the native Streamable HTTP transport.
DBX_SESSION_IDLE_TTL_SECS Optional: Idle timeout for stateful sessions in seconds (default 1800).

What it does

The DBX MCP Server connects coding assistants to the databases configured in DBX, an open-source desktop database manager that supports over 100 databases. Through it an assistant can list connections and databases, browse tables, views and collections, describe columns, read stored procedure source, get compact schema context, and run SQL, MongoDB shell commands and Redis commands, including multi-statement scripts and stateful sessions that keep one connection.

It also reads Kafka messages without committing offsets, sends messages to supported queues, handles Salesforce SOQL queries and confirmed two-step record writes, can add or remove DBX connections, and, when the DBX desktop app is running, opens a table or shows a query result in its interface.

The server is written in Rust and ships through npm as a small Node.js launcher (npx -y @dbx-app/mcp-server, Node.js 18.18 or newer) or as native binaries without Node.js. It reads connection profiles from DBX's local storage, so connections are set up in DBX first; DBX does not need to stay open for native connections. It can also point at a DBX Web or Docker backend with DBX_WEB_URL, or serve Streamable HTTP protected by a bearer token. What it may do is set in DBX Settings, MCP: an allowlist of connections and one of three modes (read only, data read/write, full access).

Tools 22

dbx_list_connections
List connections visible to the MCP session
dbx_list_databases
List databases available through a connection, respecting its MCP database scope
dbx_add_connection
Add a connection to DBX storage
dbx_duplicate_connection
Duplicate a DBX connection with its complete settings
dbx_remove_connection
Remove a connection from DBX storage
dbx_list_tables
List tables, views, collections, or message queue topics
dbx_describe_table
Return columns and table metadata
dbx_list_routines
List stored procedures and functions in a schema, with an optional routine_type filter (PROCEDURE or FUNCTION)
dbx_get_routine_source
Return the source of a stored procedure or function by name, with an optional signature for overloaded names
dbx_get_schema_context
Return compact schema context suitable for an AI model
dbx_execute_query
Execute SQL or a supported MongoDB shell command, returning 100 rows by default (up to 1000 with the max_rows parameter)
dbx_execute_batch
Execute a SQL script containing multiple statements in one call, returning a result per statement (or a single merged result with use_transaction on a multi-statement script)
dbx_open_session
Open a stateful SQL query session pinned to one backend connection
dbx_close_session
Close a session and release its pinned connection resources
dbx_execute_redis_command
Execute a Redis command
dbx_salesforce_current_user
Show the Salesforce user and org behind a connection, including the "Modify All Data" flag
dbx_salesforce_prepare_write
Prepare one Salesforce record write and return a summary plus a single-use confirm token
dbx_salesforce_apply_write
Apply a prepared Salesforce write using its confirm token
dbx_peek_messages
Read Kafka messages without committing consumer offsets
dbx_send_message
Send a message to a supported message queue topic
dbx_open_table
Open a table in the running DBX desktop application
dbx_execute_and_show
Execute a query and display the result in the DBX desktop application

Similar servers