Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "mcp-db-read-only": {
      "command": "npx",
      "args": [
        "-y",
        "@shibbirweb/[email protected]"
      ],
      "env": {
        "DB_PASSWORD": "${DB_PASSWORD}",
        "DB_PROFILES": "${DB_PROFILES}",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}"
      }
    }
  }
}

claude mcp add mcp-db-read-only -e "DB_PASSWORD=${DB_PASSWORD}" -e "DB_PROFILES=${DB_PROFILES}" -e "MYSQL_PASSWORD=${MYSQL_PASSWORD}" -- npx -y @shibbirweb/[email protected]

[mcp_servers.mcp-db-read-only]
command = "npx"
args = ["-y", "@shibbirweb/[email protected]"]
env = { "DB_PASSWORD" = "${DB_PASSWORD}", "DB_PROFILES" = "${DB_PROFILES}", "MYSQL_PASSWORD" = "${MYSQL_PASSWORD}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcp-db-read-only": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@shibbirweb/[email protected]"
      ],
      "enabled": true,
      "environment": {
        "DB_PASSWORD": "{env:DB_PASSWORD}",
        "DB_PROFILES": "{env:DB_PROFILES}",
        "MYSQL_PASSWORD": "{env:MYSQL_PASSWORD}"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-db-read-only": {
      "command": "npx",
      "args": [
        "-y",
        "@shibbirweb/[email protected]"
      ],
      "env": {
        "DB_PASSWORD": "${DB_PASSWORD}",
        "DB_PROFILES": "${DB_PROFILES}",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=mcp-db-read-only&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzaGliYmlyd2ViL21jcC1kYi1yZWFkLW9ubHlAMS4xLjAiXSwiZW52Ijp7IkRCX1BBU1NXT1JEIjoiJHtEQl9QQVNTV09SRH0iLCJEQl9QUk9GSUxFUyI6IiR7REJfUFJPRklMRVN9IiwiTVlTUUxfUEFTU1dPUkQiOiIke01ZU1FMX1BBU1NXT1JEfSJ9fQ%3D%3D"
}

{
  "servers": {
    "mcp-db-read-only": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shibbirweb/[email protected]"
      ],
      "env": {
        "DB_PASSWORD": "${DB_PASSWORD}",
        "DB_PROFILES": "${DB_PROFILES}",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-db-read-only": {
      "command": "npx",
      "args": [
        "-y",
        "@shibbirweb/[email protected]"
      ],
      "env": {
        "DB_PASSWORD": "${DB_PASSWORD}",
        "DB_PROFILES": "${DB_PROFILES}",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}"
      }
    }
  }
}

extensions:
  "mcp-db-read-only":
    enabled: true
    name: "mcp-db-read-only"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "@shibbirweb/[email protected]"
    envs:
      "DB_PASSWORD": "${DB_PASSWORD}"
      "DB_PROFILES": "${DB_PROFILES}"
      "MYSQL_PASSWORD": "${MYSQL_PASSWORD}"
    timeout: 300

Placeholders to fill from your own secret store: ${DB_PASSWORD}, ${DB_PROFILES}, ${MYSQL_PASSWORD}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies50 · weight 15

warn
deps.known_vulns1 advisory of lower severity or without a published fix: GHSA-hp3w-g68c-fv3c in [email protected] (indirect, no fix yet)
fail
deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
pass
deps.resolvable@shibbirweb/[email protected] resolved: 207 packages

Tool list unknown · checked 2026-10-20 15:26 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90

livenessn/a

freshness100

hygiene95

+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-26d-ago -unpinned-packages(1)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@shibbirweb/[email protected] npm206 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19

advisory	severity	package	fixed in
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server	high	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.31.0`
GHSA-hp3w-g68c-fv3csprintf-js vulnerable to denial of service through unbounded precision specifiers	moderate	`[email protected]`indirect	no fix yet

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`@shibbirweb/mcp-db-read-only`	npm	1.1.0	–	`DB_PASSWORD`, `DB_PROFILES`, `MYSQL_PASSWORD`
`docker.io/shibbirweb/mcp-db-read-only:1.1.0`	oci	unpinned	–	`DB_PASSWORD`, `DB_PROFILES`, `MYSQL_PASSWORD`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

More from io.github.shibbirweb

Official server.json

{
  "name": "io.github.shibbirweb/mcp-db-read-only",
  "title": "Databases (read-only, switchable)",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.1.0",
  "packages": [
    {
      "version": "1.1.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@shibbirweb/mcp-db-read-only",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "DB_URL",
          "format": "string",
          "description": "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"
        },
        {
          "name": "DB_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Password for DB_URL, so it need not be percent-encoded inside the URL"
        },
        {
          "name": "DB_PROFILES",
          "format": "string",
          "isSecret": true,
          "description": "JSON object of named connections to switch between, each a URL or {\"url\", \"password\"}"
        },
        {
          "name": "DB_DEFAULT_PROFILE",
          "format": "string",
          "description": "Which DB_PROFILES entry to start on"
        },
        {
          "name": "DB_CONNECT_TIMEOUT_MS",
          "format": "number",
          "description": "Connection timeout in milliseconds. Defaults to 10000"
        },
        {
          "name": "DB_QUERY_TIMEOUT_MS",
          "format": "number",
          "description": "Server-side query timeout in milliseconds. Defaults to 30000"
        },
        {
          "name": "DB_LOG",
          "format": "boolean",
          "description": "true logs every tool call, its statements and full output to stderr. Off by default"
        },
        {
          "name": "DB_LOG_FILE",
          "format": "filepath",
          "description": "Log every tool call to this file instead. Implies DB_LOG"
        },
        {
          "name": "DB_LOG_DIR",
          "format": "filepath",
          "description": "Save every tool call as its own JSON file in this folder, permanently. Implies logging"
        },
        {
          "name": "DB_LOG_FORMAT",
          "format": "string",
          "description": "pretty (default) or json, one object per line"
        },
        {
          "name": "DB_LOG_PORT",
          "format": "number",
          "description": "Serve a live log viewer in the browser on this port. Needs DB_LOG_DIR, DB_LOG or DB_LOG_FILE. No access control"
        },
        {
          "name": "DB_LOG_HISTORY",
          "format": "number",
          "description": "Entries the viewer keeps in memory when DB_LOG_DIR is not set. Defaults to 500"
        },
        {
          "name": "MYSQL_HOST",
          "format": "string",
          "description": "Legacy MySQL-only form, kept for drop-in compatibility. Prefer DB_URL"
        },
        {
          "name": "MYSQL_USER",
          "format": "string",
          "description": "Legacy MySQL-only form. Prefer DB_URL"
        },
        {
          "name": "MYSQL_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Legacy MySQL-only form. Prefer DB_URL with DB_PASSWORD"
        },
        {
          "name": "MYSQL_DATABASE",
          "format": "string",
          "description": "Legacy MySQL-only form. Prefer DB_URL"
        }
      ]
    },
    {
      "transport": {
        "type": "stdio"
      },
      "identifier": "docker.io/shibbirweb/mcp-db-read-only:1.1.0",
      "registryType": "oci",
      "environmentVariables": [
        {
          "name": "DB_URL",
          "format": "string",
          "description": "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. Use host.docker.internal to reach the host"
        },
        {
          "name": "DB_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Password for DB_URL, so it need not be percent-encoded inside the URL"
        },
        {
          "name": "DB_PROFILES",
          "format": "string",
          "isSecret": true,
          "description": "JSON object of named connections to switch between, each a URL or {\"url\", \"password\"}"
        },
        {
          "name": "DB_DEFAULT_PROFILE",
          "format": "string",
          "description": "Which DB_PROFILES entry to start on"
        },
        {
          "name": "DB_CONNECT_TIMEOUT_MS",
          "format": "number",
          "description": "Connection timeout in milliseconds. Defaults to 10000"
        },
        {
          "name": "DB_QUERY_TIMEOUT_MS",
          "format": "number",
          "description": "Server-side query timeout in milliseconds. Defaults to 30000"
        },
        {
          "name": "DB_LOG",
          "format": "boolean",
          "description": "true logs every tool call, its statements and full output to stderr. Off by default"
        },
        {
          "name": "DB_LOG_FILE",
          "format": "filepath",
          "description": "Log every tool call to this file instead, on a mounted volume. Implies DB_LOG"
        },
        {
          "name": "DB_LOG_DIR",
          "format": "filepath",
          "description": "Save every tool call as its own JSON file in this folder, on a mounted volume. Implies logging"
        },
        {
          "name": "DB_LOG_FORMAT",
          "format": "string",
          "description": "pretty (default) or json, one object per line"
        },
        {
          "name": "DB_LOG_PORT",
          "format": "number",
          "description": "Serve a live log viewer on this port (publish it with -p). Needs DB_LOG_DIR, DB_LOG or DB_LOG_FILE. No access control"
        },
        {
          "name": "DB_LOG_HISTORY",
          "format": "number",
          "description": "Entries the viewer keeps in memory when DB_LOG_DIR is not set. Defaults to 500"
        },
        {
          "name": "MYSQL_HOST",
          "format": "string",
          "description": "Legacy MySQL-only form, kept for drop-in compatibility. Prefer DB_URL"
        },
        {
          "name": "MYSQL_USER",
          "format": "string",
          "description": "Legacy MySQL-only form. Prefer DB_URL"
        },
        {
          "name": "MYSQL_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Legacy MySQL-only form. Prefer DB_URL with DB_PASSWORD"
        },
        {
          "name": "MYSQL_DATABASE",
          "format": "string",
          "description": "Legacy MySQL-only form. Prefer DB_URL"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/shibbirweb/mcp-db-read-only",
    "source": "github"
  },
  "websiteUrl": "https://github.com/shibbirweb/mcp-db-read-only#readme",
  "description": "Read-only SQL, MongoDB, Redis and Elasticsearch access, switchable mid-conversation."
}