MCP Percona Pg

Name: MCP Percona Pg
Author: dockndevai

作者：dockndevaiバージョン 0.3.3i★ –iパソコンで動く

レジストリ名io.github.dockndevai/mcp-percona-pg

インストール

概要

作者による説明（英語の原文）

Manage Percona PostgreSQL + PgBouncer on Kubernetes — safe-by-default access modes and guards.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: データベース・データセット

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： KUBECONFIG_PATH, PERCONA_MODE, PERCONA_NAMESPACE

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "percona-pg": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-percona-pg"
      ],
      "env": {
        "KUBECONFIG_PATH": "your-value",
        "PERCONA_MODE": "your-value",
        "PERCONA_NAMESPACE": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add percona-pg --env KUBECONFIG_PATH=your-value --env PERCONA_MODE=your-value --env PERCONA_NAMESPACE=your-value -- npx -y @dockndevai/mcp-percona-pg

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "percona-pg": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-percona-pg"
      ],
      "env": {
        "KUBECONFIG_PATH": "your-value",
        "PERCONA_MODE": "your-value",
        "PERCONA_NAMESPACE": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "percona-pg": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-percona-pg"
      ],
      "env": {
        "KUBECONFIG_PATH": "your-value",
        "PERCONA_MODE": "your-value",
        "PERCONA_NAMESPACE": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

KUBECONFIG_PATH env
Path to a kube-config file that can reach the Percona Operator namespaces (empty = default resolution).
PERCONA_MODE env
Access mode: read-only | read-write | admin.
PERCONA_NAMESPACE env
Default namespace for PerconaPGCluster resources when a tool omits one.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント dockndevai で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

データベース・データセットのほかのサーバーとの比較i

このカテゴリのほかの954件のうち0%よりスターが多い
このカテゴリのほかの954件のうち79%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの954件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

MCP Percona Pgは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.3.3）がレジストリに届いたのは12 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Supabase, MongoDB MCP Server, Elasticsearch MCP Server

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況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.03 日前更新

インストール

Elasticsearch MCP Server

作者：cr7258

MCP server for interacting with Elasticsearch

パソコンで動く★ 315Apache-2.014 か月前更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

mcp-percona-pg

A Model Context Protocol server for the [Percona Operator for PostgreSQL](https://docs.percona.com/percona-operator-for-postgresql/2.0/). It lets an MCP-capable client (Claude Desktop, Claude Code, Cursor, …) operate PostgreSQL + PgBouncer clusters on Kubernetes — topology, connection pooling, tuning, backups/PITR, DR, extensions, and lifecycle — with behaviour controlled entirely by flags.

It drives the operator's custom resources (PerconaPGCluster, PerconaPGBackup, PerconaPGRestore, PerconaPGUpgrade) through your kube-config, so the model works the way you already do: *"scale dev-pg to 3 replicas"*, *"switch pooling to transaction mode"*, *"restore prod-pg to 12:00 UTC"*.

Safe by default: it starts read-only, can be scoped to an allowlist of namespaces and clusters, protects critical clusters from mutation, gates restore / upgrade / delete behind separate opt-ins, and requires typed confirmation for high-impact actions. It never reads or returns database credentials.

Features

Discovery & status — list clusters, per-cluster summary and raw .status (Patroni members, PostgreSQL/PgBouncer readiness), connection endpoints, backups and restores.
Connection pooling — read and update PgBouncer pool_mode and the global pool tunables (default_pool_size, max_client_conn, …).
PostgreSQL tuning — read/merge parameters via spec.patroni.dynamicConfiguration (the only Patroni-safe path).
Lifecycle — scale PostgreSQL/PgBouncer, pause/resume, toggle built-in extensions, on-demand backups.
DR & recovery — restore / point-in-time recovery, promote a standby, major-version upgrades — each individually gated.

Security model

Layer	Flag	Effect
Access mode	`PERCONA_MODE`	`read-only` → `read-write` → `admin`; over-privileged tools are never registered
Namespace/cluster allowlists	`PERCONA_NAMESPACE_ALLOWLIST`, `PERCONA_CLUSTER_ALLOWLIST`	scope what the agent can touch
Protected clusters	`PERCONA_PROTECTED_CLUSTERS`	readable, never mutated/restored/deleted
Restore / upgrade / delete	`PERCONA_ALLOW_RESTORE`, `PERCONA_ALLOW_UPGRADE`, `PERCONA_ALLOW_DELETE`	separate opt-ins on top of admin mode
Confirmation	`PERCONA_REQUIRE_CONFIRMATION`	high-impact ops require echoing the cluster name
Dry-run / audit	`PERCONA_DRY_RUN`, `PERCONA_AUDIT_LOG`	validate-only; JSON audit line per guarded op
Interactive confirmation	(automatic)	destructive & high-impact ops prompt the human to approve via MCP elicitation before running; fall back to the `PERCONA_ALLOW_*` gates when the client can't elicit

Tools

Read (read-only+): list_contexts, list_clusters, get_cluster, get_cluster_status, get_connection_info, get_pgbouncer_config, get_pg_parameters, list_backups, list_restores

Write (read-write+): scale_cluster, set_pgbouncer_config, set_pg_parameters, pause_cluster, toggle_builtin_extension, create_backup

Admin (admin): restore_cluster (needs PERCONA_ALLOW_RESTORE), upgrade_cluster (needs PERCONA_ALLOW_UPGRADE), promote_standby, delete_backup / delete_cluster (need PERCONA_ALLOW_DELETE)

Quickstart — add to your agent

Published on npm as @dockndevai/mcp-percona-pg. No clone or build needed — your MCP client runs it on demand with npx. Start in `read-only` mode; see .env.example for every variable and docs/CLIENTS.md for the full per-client guide.

Claude Code (CLI)

claude mcp add percona-pg -e PERCONA_MODE="read-only" -e PERCONA_NAMESPACE="postgres-operator" -- npx -y @dockndevai/mcp-percona-pg

Claude Desktop · Cursor · Windsurf — same block in claude_desktop_config.json, .cursor/mcp.json, or ~/.codeium/windsurf/mcp_config.json:

"mcpServers": { "percona-pg": { "command": "npx", "args": ["-y", "@dockndevai/mcp-percona-pg"], "env": { "PERCONA_MODE": "read-only", "PERCONA_NAMESPACE": "postgres-operator" } } } }

OpenAI Codex CLI — in ~/.codex/config.toml:

[mcp_servers.percona-pg]

command = "npx" args = ["-y", "@dockndevai/mcp-percona-pg"] env = { PERCONA_MODE = "read-only", PERCONA_NAMESPACE = "postgres-operator" }

Example prompts

*"List the PostgreSQL clusters and show me the status of dev-pg."*
*"What pool_mode is dev-pg using, and how big is the default pool?"* → get_pgbouncer_config
*"Set dev-pg PgBouncer to transaction pooling with default_pool_size 25."* (needs read-write)
*"Bump shared_buffers to 512MB on dev-pg."* (needs read-write)
*"Take a full backup of dev-pg to repo1."* (needs read-write)
*"Restore dev-pg to 2026-08-30 12:00:00+00."* (needs admin + PERCONA_ALLOW_RESTORE + confirmation)

Prerequisites

A Kubernetes cluster running the Percona Operator for PostgreSQL v2 (pgv2.percona.com/v2).
A kube-config the server can read. For safety, use a ServiceAccount/RBAC scoped to the operator's namespaces and to the pgv2.percona.com resources you want the agent to see.

Run from source (development)

Prefer the published package above. To run from a clone:

npm install

npm run build node dist/index.js # with the environment variables set

Develop

npm run dev

npm test # security policy + annotations npm run typecheck

Publishing

This server ships a server.json for the official MCP registry and an mcpName for npm ownership validation. See [PUBLISHING.md](PUBLISHING.md).

License

MIT

MCP Percona Pg

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

データベース・データセットのほかのサーバーとの比較i

よくある質問

代わりの候補

Supabase

MongoDB MCP Server

Elasticsearch MCP Server

作者のREADME

mcp-percona-pg

Features

Security model

Tools

Quickstart — add to your agent

Example prompts

Prerequisites

Run from source (development)

Develop

Publishing

License