PostgreSQL Multi-Schema MCP Server

PostgreSQL マルチスキーマ MCP サーバー

マルチスキーマ対応を強化した、PostgreSQL データベースへの読み取り専用アクセスを提供する Model Context Protocol サーバーです。このサーバーを使用すると、LLM は複数の名前空間にまたがるデータベーススキーマを調査し、スキーマの分離を維持しながら読み取り専用クエリを実行できます。

主な機能

• マルチスキーマ対応：コマンドライン設定で公開するスキーマを明示的に指定できます
• スキーマ分離：サーバー起動時に指定した許可済みスキーマのみにアクセスを厳密に制限します
• スキーマをまたいだ検出：スキーマの境界を維持しながら、複数のスキーマにまたがるテーブルを統一して表示します
• メタデータのセキュリティ：システムカタログをフィルタリングし、指定されたスキーマ内のユーザー定義テーブルのみを公開します

コンポーネント

ツール

• query
  • 接続されたデータベースに対して読み取り専用 SQL クエリを実行します
  • 入力：sql（文字列）：実行する SQL クエリ
  • すべてのクエリは READ ONLY トランザクション内で実行されます
  • search_path の制限によってスキーマコンテキストが維持されます

リソース

サーバーは、許可されたスキーマ内の各テーブルについてスキーマ情報を提供します。

• テーブルスキーマ（postgres://<host>/<db_schema>/<table>/schema）
  • 各テーブルの JSON スキーマ情報
  • カラム名、データ型、型修飾子が含まれます
  • データベースのメタデータから自動的に検出されます
  • スキーマの許可リストを明示的に指定するマルチスキーマ対応

使用方法

このサーバーにはデータベース URL が必要です。また、公開するスキーマをカンマ区切りのリストで指定できます。

npx -y mcp-server-postgres-multi-schema <database-url> [schemas]

• database-url：PostgreSQL の接続文字列（例：postgresql://localhost/mydb）
• schemas：公開するスキーマのカンマ区切りリスト（指定しない場合はデフォルトで「public」）

例

# Connect with default public schema
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb

# Connect with multiple schemas
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb public,analytics,staging

Claude Desktop での使用方法

claude_desktop_config.json の「mcpServers」セクションを設定します。

NPX

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-postgres-multi-schema",
        "postgresql://localhost/mydb",
        "public,audit"
      ]
    }
  }
}

ライセンス

このマルチスキーマ MCP サーバーは MIT License のもとでライセンスされています。LICENSE ファイルの条件に従って、ソフトウェアを使用、変更、配布できます。