Databases (read-only, switchable) MCP Server

io.github.shibbirweb/mcp-db-read-only

Repository Registry

What is the Databases (read-only, switchable) MCP server?

Read-only SQL, MongoDB, Redis and Elasticsearch access, switchable mid-conversation.

How to install Databases (read-only, switchable)

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

DB_URL
Connection URL to open at startup, e.g. postgres://user@host:5432/db, mongodb://user@host/db, redis://host:6379/0 or sqlite:///data/app.db
DB_PASSWORD
secret
Password for DB_URL, so it need not be percent-encoded inside the URL
DB_PROFILES
secret
JSON object of named connections to switch between, each a URL or {"url", "password"}
DB_DEFAULT_PROFILE
Which DB_PROFILES entry to start on
DB_CONNECT_TIMEOUT_MS
Connection timeout in milliseconds. Defaults to 10000
DB_QUERY_TIMEOUT_MS
Server-side query timeout in milliseconds. Defaults to 30000
DB_LOG
true logs every tool call, its statements and full output to stderr. Off by default
DB_LOG_FILE
Log every tool call to this file instead. Implies DB_LOG
DB_LOG_DIR
Save every tool call as its own JSON file in this folder, permanently. Implies logging
DB_LOG_FORMAT
pretty (default) or json, one object per line
DB_LOG_PORT
Serve a live log viewer in the browser on this port. Needs DB_LOG_DIR, DB_LOG or DB_LOG_FILE. No access control
DB_LOG_HISTORY
Entries the viewer keeps in memory when DB_LOG_DIR is not set. Defaults to 500
MYSQL_HOST
Legacy MySQL-only form, kept for drop-in compatibility. Prefer DB_URL
MYSQL_USER
Legacy MySQL-only form. Prefer DB_URL
MYSQL_PASSWORD
secret
Legacy MySQL-only form. Prefer DB_URL with DB_PASSWORD
MYSQL_DATABASE
Legacy MySQL-only form. Prefer DB_URL

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-db-read-only": {
      "command": "npx",
      "args": [
        "-y",
        "@shibbirweb/mcp-db-read-only"
      ],
      "env": {
        "DB_URL": "<YOUR_DB_URL>",
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DB_PROFILES": "<YOUR_DB_PROFILES>",
        "DB_DEFAULT_PROFILE": "<YOUR_DB_DEFAULT_PROFILE>",
        "DB_CONNECT_TIMEOUT_MS": "<YOUR_DB_CONNECT_TIMEOUT_MS>",
        "DB_QUERY_TIMEOUT_MS": "<YOUR_DB_QUERY_TIMEOUT_MS>",
        "DB_LOG": "<YOUR_DB_LOG>",
        "DB_LOG_FILE": "<YOUR_DB_LOG_FILE>",
        "DB_LOG_DIR": "<YOUR_DB_LOG_DIR>",
        "DB_LOG_FORMAT": "<YOUR_DB_LOG_FORMAT>",
        "DB_LOG_PORT": "<YOUR_DB_LOG_PORT>",
        "DB_LOG_HISTORY": "<YOUR_DB_LOG_HISTORY>",
        "MYSQL_HOST": "<YOUR_MYSQL_HOST>",
        "MYSQL_USER": "<YOUR_MYSQL_USER>",
        "MYSQL_PASSWORD": "<YOUR_MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<YOUR_MYSQL_DATABASE>"
      }
    }
  }
}

Related MCP servers

MySQL (read-only, switchable)

Active

Read-only MySQL access, with the database and server switchable mid-conversation.

TypeScript

MIT

View repository →

AIDataParser

Active

Extract schema-guaranteed JSON from PDFs, images and messy text. 50 free credits, no card.

JavaScript

MIT

View repository →

AISOTools

Active

Search, compare, and find alternatives across a catalog of 3,000+ AI tools.

MIT

View repository →

API Status Check

Active

Live status probes plus published uptime and incident history for 280+ APIs and cloud services.

JavaScript

MIT

View repository →

MyMCPTools

Active

Find MCP servers and check whether they actually respond, via live handshake probes.

JavaScript

MIT

View repository →

io.github.shichuanqiong/agoradm

Active

DM / IM + public arena for AI agents (A2A 1.0) — hosted endpoint or local package.

Python

Apache-2.0

View repository →