PostgreSQL MCP Server

MCP PostgreSQLサーバー

これは、PostgreSQLデータベースとやり取りするためのモデルコンテキストプロトコル（CMP）サーバーです。PostgreSQLデータベースへのクエリとスキーマの検査を行うための読み取り専用インターフェースを提供します。

インストール

構成

サーバーは複数の方法で構成できます。優先順位は次のとおりです。

1. 環境変数
   • POSTGRES_URL : 完全なデータベース URL (例: postgres://user:pass@host:5432/dbname )
   • 個別の接続パラメータ:
     • POSTGRES_HOST : データベースホスト
     • POSTGRES_PORT : データベースポート（デフォルト: 5432）
     • POSTGRES_DB : データベース名
     • POSTGRES_USER : データベースユーザー
     • POSTGRES_PASSWORD : データベースパスワード
     • POSTGRES_SSL : SSL モードを有効にする (有効にするには 'true' に設定)
     • POSTGRES_SCHEMA : データベーススキーマ（デフォルト: 'public'）
   • 追加構成:
     • DOTENV_PATH : .env ファイルへのカスタムパス
     • DEBUG_MCP : デバッグログを有効にする（有効にするには「true」に設定）
2. コマンドライン
   npx @hthuong09/postgres-mcp "postgres://user:pass@host:5432/dbname"

リソース

• テーブルスキーマ: データベース内の各テーブルはリソースとして公開されます
• リソース URI 形式: postgres://user@host/dbname/table_name/schema
• レスポンス形式: 列定義のJSON配列（名前とデータ型）

使用例

1. 環境変数の使用:
   export POSTGRES_HOST=localhost export POSTGRES_DB=mydb export POSTGRES_USER=myuser export POSTGRES_PASSWORD=mypassword npx @hthuong09/postgres-mcp
2. 接続 URL の使用:
   npx @hthuong09/postgres-mcp "postgres://myuser:mypassword@localhost:5432/mydb"
3. SSL で環境変数を使用する:
   export POSTGRES_HOST=db.example.com export POSTGRES_DB=mydb export POSTGRES_USER=myuser export POSTGRES_PASSWORD=mypassword export POSTGRES_SSL=true npx @hthuong09/postgres-mcp
4. カスタム .env ファイルの場所を使用する:
   DOTENV_PATH=/path/to/.env npx @hthuong09/postgres-mcp

セキュリティに関する考慮事項

• データベースの資格情報は安全に保管する必要がある
• プロセスリストで資格情報が公開されないように、本番環境ではコマンドライン引数の代わりに環境変数または .env ファイルを使用します。
• 実稼働環境ではSSLの使用を検討する
• サーバーは安全のため読み取り専用トランザクションのみを許可します
• パスワードはリソースURIから自動的に削除されます

発達

ローカルでサーバーを構築するには:

開発中にウォッチモードで実行するには:

デバッグ

デバッグログを有効にするには、 DEBUG_MCP=trueを設定します。ログは次の場所に書き込まれます。

• Unix/macOS: /tmp/postgres-mcp-debug.json
• Windows: %TEMP%/postgres-mcp-debug.json

ライセンス

マサチューセッツ工科大学