Custom MCP Database

An MCP server that lets AI agents run alias-based queries against PostgreSQL, MySQL, MongoDB and Oracle - without ever exposing credentials to the model. Connections are configured once and stored locally; the agent only ever references them by alias.

People connecting database tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-01 · ★ 3 · #96 OF 151 MAINTAINED DATABASE · VERIFIED 2026-08-25

Python servers · how we verify → /methodology

01 · Install Custom MCP Database

before you install - you'll need

Set MYSQL_PW, MCP_DB_READONLY, MCP_DB_ALLOW_WRITES before connecting.

Claude Code

claude mcp add renanlido-custom-mcp-database -- uvx custom-mcp-database

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "renanlido-custom-mcp-database": {
      "command": "uvx",
      "args": [
        "custom-mcp-database"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license no standard license detected - usage rights unclear; check the repo before commercial use

pypi package custom-mcp-database - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.renanlido is GitHub-verified and matches the repo owner

03 · What Custom MCP Database can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.6.2 · 2026-06-20

[0.6.2] - 2026-06-20 · Other · add security CI (CodeQL, Dependabot, pip-audit, gitleaks) and fix CI smoke tool surface

v0.6.1 · 2026-06-20

[0.6.1] - 2026-06-20 · Fixes · preserve special characters in password/uri files (trim only one trailing newline)

v0.6.0 · 2026-06-20

[0.6.0] - 2026-06-20 · add interactive 'setup' wizard for guided, secret-safe connection creation

04 · Who maintains Custom MCP Database

custom-mcp-database is maintained by renanlido. It's the only MCP server we track from this author; the repo dates to Jul 2025.

05 · Facts

repository: github.com/renanlido/custom-mcp-database
category: database - ranked #96 of 151 actively-maintained database servers as of 2026-08-25.
release cadence: 8 releases in the last 90 days (latest 2026-06-20)
registry: io.github.renanlido/custom-mcp-database (active, first published 2026-06-20 · 7 versions)
packages: pypi:custom-mcp-database

06 · Custom MCP Database FAQ

What is Custom MCP Database?

Is Custom MCP Database still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-01 and it shipped 8 releases in the last 90 days. We re-verify nightly.

How do I install Custom MCP Database?

Run `uvx custom-mcp-database`. The README documents 3 environment variables (MYSQL_PW, MCP_DB_READONLY, MCP_DB_ALLOW_WRITES) to set first. Set MYSQL_PW, MCP_DB_READONLY, MCP_DB_ALLOW_WRITES before connecting. You can also paste the ready-made client config above.

Does Custom MCP Database run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Custom MCP Database

Alternatives to Custom MCP Database

Maintained database servers if Custom MCP Database isn't the fit.

Pairs well with

Servers that cover what Custom MCP Database doesn't - only shown when the pairing reason fits the companion.

More database MCP servers · Health Bridge for AI · RTFM · 4da MCP Server · SAP HANA CLI · Scalix Cloud

More Python MCP servers · Repowise · Page Map · PSX MCP · Linux MCP Server · Prolog Reasoner · see all