Postgres MCP

🚀 PostgreSQL モデルコンテキストプロトコル (Model Context Protocol) サーバー

このサーバーは、PostgreSQL データベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコルサーバーです。大規模言語モデル (LLMs) がデータベーススキーマを調査し、読み取り専用クエリを実行できるようにします。

✨ 主な機能

ツール

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

リソース

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

• テーブルスキーマ (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 License に基づいて配布されています。これは、MIT License の条項と条件に従う限り、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。