Custom MCP Database

Name: Custom MCP Database
Author: renanlido

제작자: renanlido버전 0.6.2i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.renanlido/custom-mcp-database

설치

개요

제작자가 쓴 설명(영어 원문)

Run alias-based queries against PostgreSQL, MySQL, MongoDB and Oracle without exposing credentials.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 데이터베이스 및 데이터셋

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

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

터미널에서 이 명령어를 실행하세요

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

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "custom-database": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "custom-mcp-database"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 renanlido 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

데이터베이스 및 데이터셋 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 954개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 954개 중 16%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 954개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Custom MCP Database, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.6.2)은 5개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Supabase, MongoDB MCP Server, Elasticsearch MCP Server

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Supabase

제작자: supabase

MCP server for interacting with the Supabase platform

컴퓨터 또는 클라우드★ 2,993Apache-2.0어제 업데이트

설치

MongoDB MCP Server

제작자: mongodb-js

MongoDB Model Context Protocol Server

내 컴퓨터에서 실행★ 1,157Apache-2.0그저께 업데이트

설치

Elasticsearch MCP Server

제작자: cr7258

MCP server for interacting with Elasticsearch

내 컴퓨터에서 실행★ 315Apache-2.014개월 전 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

Custom MCP Database

mcp-name: io.github.renanlido/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.

Works with Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI, and any other MCP client (all use the same stdio launch command).

Quickstart

There are two roles, on purpose. Keeping them separate is what stops your DB password from ever reaching the model.

You (once, in your terminal) — install the credentials

The agent never installs credentials. You do, with the CLI. The secret stays on your machine and is never sent to the model.

Easiest way — the guided wizard (asks type, host, user, and how to supply the secret; optionally tests the connection):

uvx custom-mcp-database setup

Or do it in one line (you'll be prompted for the password — hidden input):

uvx custom-mcp-database add-db --alias prod_ro --type postgres \

--host db.internal --port 5432 --user reporting --dbname app

uvx custom-mcp-database list-aliases # confirm it's there

The agent (always) — uses it by alias

Point your MCP client at the server (see Install), then just ask:

"Using prod_ro, run SELECT count(*) FROM orders."

The agent calls db_execute_query with the alias prod_ro — never a host, user, or password. It physically cannot see the credentials; they live in your local config, resolved only inside the server process at query time.

Why the agent can't add the DB: an MCP tool's arguments are produced and read by the LLM. If the agent typed your password into an add tool, that password would land in the model's context, the provider, and the logs. So credential setup is a human/CLI step by design. (Need an agent to wire connections in an automated pipeline? See MCP_DB_ALLOW_ADMIN_TOOLS in SECURITY.md — even then it only accepts a *reference* to a secret, e.g. an env-var name, never the secret itself.)

Writes are off by default (read-only). To allow them for a task: export MCP_DB_READONLY=0 MCP_DB_ALLOW_WRITES=1.

Install

The server runs over stdio. The universal launch command is uvx custom-mcp-database run (requires uv; the package is fetched from PyPI on first run).

Claude Code

# Direct (published package)

claude mcp add custom-mcp-database -- uvx custom-mcp-database run

Or install the full plugin from this repo's marketplace

/plugin marketplace add renanlido/custom-mcp-database /plugin install custom-mcp-database@renanlido-mcp

Claude Desktop

Two options:

One-click bundle — build the .mcpb (mcpb pack) and open it in Claude Desktop. See Distribution.
Manual config — add the snippet from examples/mcp-clients/claude-desktop.json to claude_desktop_config.json.

Other clients

Copy the matching snippet — all use the same command/args, only the file and key differ:

Client	Config file	Key	Snippet
Cursor	`~/.cursor/mcp.json`	`mcpServers`	cursor.json
VS Code	`.vscode/mcp.json`	`servers`	vscode.json
Windsurf	`~/.codeium/windsurf/mcp_config.json`	`mcpServers`	windsurf.json
Gemini CLI	`~/.gemini/settings.json`	`mcpServers`	gemini-cli.json

Full client matrix and a local-checkout variant: examples/mcp-clients/README.md.

Configure connections

Configure connections from your terminal with the CLI — never through the agent. A connection's password is a real secret; if it were passed as an MCP tool argument it would enter the model's context (and the provider, transcripts, and logs). So the credential-management tools are off the MCP surface by default; provisioning is a human/CLI task. The agent only lists and uses aliases.

Omit --password/--uri to be prompted securely (hidden input, not stored in shell history). Even better, keep the secret out of the config file entirely with --password-env / --password-file (resolved at connection time):

# PostgreSQL — prompted for the password (recommended)

uvx custom-mcp-database add-db --alias pg --type postgres \ --host localhost --port 5432 --user me --dbname app

MySQL — password taken from an env var at connect time (nothing secret on disk)

MYSQL_PW=... uvx custom-mcp-database add-db --alias my --type mysql \ --host localhost --port 3306 --user root --dbname app --password-env MYSQL_PW

Oracle — password read from a file (e.g. a mounted secret)

uvx custom-mcp-database add-db --alias ora --type oracle \ --host db.example.com --port 1521 --user system --dbname ORCLPDB1 \ --password-file /run/secrets/ora_pw

MongoDB — full URI from a file (the URI embeds credentials)

uvx custom-mcp-database add-db --alias mongo --type mongo \ --dbname app --uri-file /run/secrets/mongo_uri

uvx custom-mcp-database list-aliases uvx custom-mcp-database remove-db --alias pg

Config location (override with MCP_DB_CONFIG): $XDG_CONFIG_HOME/custom-mcp-database/mcp_config.sqlite3 (default ~/.config/custom-mcp-database/mcp_config.sqlite3, 0600).

If you pass a literal --password/--uri, it is stored as plaintext JSON in that

SQLite file. Prefer --password-env/--password-file (or --uri-env/--uri-file) so

only a reference is stored. Either way, keep the file secret (it is 0600, gitignored,

not encrypted).

MCP tools

Tool	Purpose
`db_list_aliases`	List configured aliases and types
`db_execute_query`	Run SQL or a MongoDB JSON filter
`db_list_collections`	List MongoDB collections
`db_security_status`	Report the active security policy

db_add_database / db_remove_database are not exposed over MCP by default — manage connections with the CLI. To opt into exposing them (the add tool only accepts secrets by reference, never a literal password), set MCP_DB_ALLOW_ADMIN_TOOLS=1.

db_execute_query notes: SQL runs as given with parameterized binds (add your own LIMIT); MongoDB takes a JSON filter + collection, caps results at 10 (--limit), rejects empty filters, and coerces 24-char hex strings to ObjectId.

Security

This server handles real credentials and production data, so it ships deny-by-default:

Read-only by default. Only SELECT-class SQL runs. Writes/DDL require explicit opt-in.
No stacked statements (;-injection blocked), single statement per call.
MongoDB server-side JavaScript blocked ($where, $function, $accumulator, mapReduce, …).
Identifiers validated (oracle_schema can't be used for injection).
Results capped at MCP_DB_MAX_ROWS (default 1000); secrets redacted from errors.
Credential store is 0600 plaintext SQLite — keep the host disk encrypted.

Check the live posture: custom-mcp-database security-status (or the db_security_status tool).

Enable writes for a specific task (then turn it back off):

export MCP_DB_READONLY=0

export MCP_DB_ALLOW_WRITES=1 # INSERT/UPDATE/DELETE

export MCP_DB_ALLOW_DDL=1 # only if you really need CREATE/DROP/ALTER/...

Read the full protocol — least-privilege DB roles, TLS, prompt-injection handling, vulnerability reporting — in [SECURITY.md](SECURITY.md). The app-layer guards are defense-in-depth; the authoritative control is a least-privilege database account.

Develop

uv sync                 # create .venv and install deps

make run # run the server (stdio) make lint # ruff make build # sdist + wheel into dist/

Inspect tools interactively:

uv run mcp dev src/custom_mcp_database/server.py

Distribution

This repo ships ready-to-publish metadata for every major channel. All of it is published automatically on push to main (see below):

Channel	File	Published by
PyPI	`pyproject.toml`	`release.yml` (push to main)
MCP Registry	`server.json`	`release.yml` (push to main)
Claude Code plugin	`.claude-plugin/plugin.json`, `.mcp.json`	available on GitHub push
Claude Code marketplace	`.claude-plugin/marketplace.json`	available on GitHub push
Claude Desktop bundle	`manifest.json`	`release.yml` attaches `.mcpb` to the Release

Automated release — just push to `main`

Releases are fully automated. On every push to main, .github/workflows/release.yml:

Picks the next semantic version from your commits since the last tag (feat: → minor, BREAKING CHANGE/type!: → major, anything else → patch; add [skip release] to a commit message to skip).
Writes that version into pyproject.toml and syncs it into every artifact (server.json, manifest.json, plugin + marketplace) via scripts/sync_version.py — version lives in one place, no hand-bumping.
Builds, commits chore(release): vX [skip ci], tags vX, pushes.
Publishes to PyPI (Trusted Publishing/OIDC), then the MCP Registry (GitHub OIDC).
Packs the `.mcpb` and cuts a GitHub Release with the wheel + bundle attached.

The release commit carries [skip ci], so it does not re-trigger the workflow.

One-time setup (can't be automated — needs your accounts):

Create a PyPI Trusted Publisher for renanlido/custom-mcp-database, workflow release.yml.
Allow GitHub Actions to push to main (repo → Settings → Actions → *Read and write permissions*; if main is a protected branch, allow the actions bot to bypass or use a PAT).

The MCP Registry namespace is io.github.renanlido/custom-mcp-database (GitHub-validated).

Local manual escape hatch: make build (syncs version + builds) then uv publish.

License

MIT

Custom MCP Database

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

데이터베이스 및 데이터셋 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Supabase

MongoDB MCP Server

Elasticsearch MCP Server

제작자의 README

Custom MCP Database

Quickstart

You (once, in your terminal) — install the credentials

The agent (always) — uses it by alias

Install

Claude Code

Or install the full plugin from this repo's marketplace

Claude Desktop

Other clients

Configure connections

MySQL — password taken from an env var at connect time (nothing secret on disk)

Oracle — password read from a file (e.g. a mounted secret)

MongoDB — full URI from a file (the URI embeds credentials)

MCP tools

Security

export MCP_DB_ALLOW_DDL=1 # only if you really need CREATE/DROP/ALTER/...

Develop

Distribution

Automated release — just push to main

License

Automated release — just push to `main`