MCP Server Postgres

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

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

🚀 クイックスタート

この PostgreSQL モデルコンテキストプロトコルサーバーを使用することで、大規模言語モデルが PostgreSQL データベースに対して読み取り専用の操作を行えます。以下に詳細な情報を説明します。

✨ 主な機能

ツール

• query
  • 接続された PostgreSQL データベースに対して読み取り専用の 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 ライセンスの下で公開されています。これは、MIT ライセンスの条項と条件に従い、自由にソフトウェアを使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。