MCP Pg Schema

🚀 PostgreSQL モデルコンテキストプロトコルサーバ

PostgreSQLデータベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバです。このサーバにより、大規模言語モデル（LLM）がデータベーススキーマを確認し、読み取り専用クエリを実行できます。

✨ 主な機能

ツール

• query
  • 接続されたデータベースに対する読み取り専用のSQLクエリを実行します。
  • 入力：sql (文字列)：実行するSQLクエリ
  • すべてのクエリは読み取り専用トランザクションで実行されます。

リソース

サーバは各データベーステーブルのスキーマ情報を提供します。

• テーブルスキーマ (postgres://<host>/<table>/schema)
  • 各テーブルのJSON形式のスキーマ情報です。
  • 列名とデータ型が含まれています。
  • データベースのメタデータから自動的に検出されます。

💻 使用例

Claude Desktopの使用方法

このサーバをClaude Desktopアプリケーションと一緒に使用するには、claude_desktop_config.jsonファイルの"mcpServers"セクションに以下の設定を追加してください。

Docker

• macOSでDockerを実行する場合、サーバがホストネットワーク上で実行されている場合（例：localhost）は、host.docker.internalを使用してください。
• ユーザー名/パスワードは、postgresql://user:password@host:port/db-nameの形式でPostgreSQL URLに追加できます。

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"]
    }
  }
}

NPX

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

/mydbをあなたのデータベース名に置き換えてください。

📦 インストール

Docker

docker build -t mcp/postgres -f src/postgres/Dockerfile .

📄 ライセンス

このMCPサーバはMITライセンスの下で公開されています。これは、MITライセンスの条項と条件に従う限り、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。