postgresql mcp

概要

PostgreSQL MCP（一般に Postgres MCP Pro と呼ばれる）は、AI エージェントが PostgreSQL データベースに安全かつインテリジェントにアクセスできるように設計されたオープンソースの Model Context Protocol (MCP) サーバーです。

基本的なクエリ実行をはるかに超え、構成可能な読み取り専用または読み取り/書き込みモード、包括的なパフォーマンス診断、自動化されたインデックス推奨、プロダクション環境レベルの安全機能を提供します。スキーマの探索やコーディングから、テスト、デプロイ、継続的なメンテナンスに至るまでの、フル開発ライフサイクルをサポートするために構築されています。

人気のある実装には、オリジナルの Anthropic 参照実装（セキュリティ上の考慮から現在は非推奨/アーカイブ）、コミュニティフォーク、および Crystal DBA による Postgres MCP Pro のような拡張版があります。

機能

構成可能なアクセスモード：厳格な読み取り専用トランザクション（変更を防止）またはトランザクション安全性を備えた制御された読み取り/書き込み。

スキーマ & データ探索：テーブル一覧表示、スキーマ、列、インデックス、制約の調査、自然言語を活用したクエリ実行。

パフォーマンス分析：バッファキャッシュ、バキューム状態、レプリケーション遅延、接続利用率、シーケンス制限などに対するヘルスチェック。

インデックスチューニング & Explain プラン：何千もの組み合わせをテストする高度なインデックス推奨エンジン；仮説インデックスと詳細なクエリ explain プランのサポート。

安全な SQL 実行：読み取り専用ラッパー、クエリ検証、危険な操作に対する安全対策。

AIエージェント最適化：低トークン使用量、明確な出力フォーマット、Claude、Cursor、Gemini および他の MCP クライアントとのシームレスな統合のために設計されたツール。

Docker & 簡単なデプロイ：一貫性があり依存関係のない実行のための公式 Docker イメージ。

拡張性：コミュニティ版 Postgres、RDS、Aurora、およびほとんどの PostgreSQL v12+ インスタンスをサポート。

ユースケース

AI支援データベース開発：AIエージェントに自然言語でスキーマを探索させ、最適なクエリを提案させ、またはマイグレーションを生成させます。

パフォーマンスチューニング：「遅いクエリを分析して」や「このテーブルに対するインデックスを推奨して」と尋ねることで、Explain プランを伴う実行可能なインサイトを受け取ります。

プロダクション監視：手動の SQL なしでヘルスチェックを実行し、肥大化を検出し、またはバキューム/自動バキュームを監視します。

安全なデータ分析：データ整合性を危険にさらすことなく、レポート作成、分析、またはカスタマーサポートエージェントに対して読み取り専用アクセスを許可します。

フル開発ワークフロー：最初のプロジェクトセットアップとテストから、デプロイ、継続的な最適化まで — すべてを会話型 AI が推進します。

インストール & クイックスタート

Docker を使用する場合（推奨）

公式イメージをプルして実行：

docker run -p 8080:8080 crystaldba/postgres-mcp --connection-string "postgresql://user:pass@localhost:5432/mydb"

Python / uv インストール

uv pip install postgres-mcp
uv run postgres-mcp "postgresql://user:password@localhost:5432/dbname"

クライアント向け設定（Claude Desktop、Cursorなど）

実行中のサーバーを指し示す適切なコマンド/引数を指定し、MCP設定（例：~/.cursor/mcp.json または Claude 設定）に追加してください。

詳細なドキュメント、接続例、セキュリティのベストプラクティスはリポジトリでご覧いただけます。

セキュリティに関する注意事項

• 信頼できないエージェントには読み取り専用モードを推奨します。
• Anthropic のオリジナルリファレンス実装には既知の SQL インジェクション脆弱性がありました（フォークおよび後のバージョンで修正済み）。
• 最小権限ユーザーの接続文字列を常に使用し、ネットワークレベルの制限もご検討ください。

リンク

• GitHub（Postgres MCP Pro）: crystaldba/postgres-mcp
• その他の注目すべき実装: pgEdge Postgres MCP、AWS Labs Aurora MCP、各種コミュニティフォーク。
• Model Context Protocol: 公式 MCP 仕様書。

Postgres MCP はあなたのデータベースを AI エージェントにとっての第一級ツールに変え、インテリジェントなデータ操作をアシスタントとの会話のようにシンプルにします。