Postgresql Multi Schema

🚀 PostgreSQL 多架构 MCP サーバー

PostgreSQL データベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコル (MCP) サーバーで、多スキーマサポートを強化しています。このサーバーにより、大規模言語モデル (LLMs) は複数の名前空間にまたがってデータベーススキーマを調べ、読み取り専用クエリを実行できるようになり、同時にスキーマの分離性を維持します。

✨ 主な機能

• 多スキーマサポート：コマンドラインで明示的に公開するスキーマを指定できます。
• スキーマ分離：サーバー起動時に指定された承認済みスキーマへのアクセスのみを厳格に制御します。
• スキーマ横断的な発見：複数のスキーマのテーブルを統一的に表示し、スキーマの境界を維持します。
• メタデータセキュリティ：システムカタログをフィルタリングし、ユーザー定義のテーブルと指定されたスキーマのみを表示します。

📦 コンポーネント

ツール

• 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' がデフォルト）

高度な使用法

# デフォルトのパブリックスキーマで接続
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb

# 複数のスキーマを使用
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 ファイルに記載された条項に従って、このソフトウェアを使用、変更、配布することができます。