PostgreSQL MCPサーバー

PostgreSQL用の汎用Model Context Protocol (MCP) サーバーであり、AIエージェントがPostgreSQLデータベースを安全に調査・クエリできるようにします。

機能

• list_tables: publicスキーマ内のすべてのテーブルを一覧表示します。

• get_schema: 特定のテーブルのスキーマ（列、型、NULL許容性）を取得します。

• run_query: 読み取り専用のSQLクエリ（SELECT/WITHのみ許可）を実行します。大きな応答を避けるため、最大100行の制限があります。

Related MCP server: PostgreSQL MCP Server

前提条件

• Python 3.13以上

• uv

• PostgreSQLデータベース

インストール

リポジトリをクローンした場合は、uvxまたはuv runを使用して直接実行できます。

使用方法

このサーバーを使用するには、DATABASE_URL環境変数を設定する必要があります。

接続文字列の例: postgres://user:password@localhost:5432/mydatabase

直接実行する場合

DATABASE_URL="postgresql://postgres:poggerpogger@localhost:5432/boxboxWeb" uv run main.py

Claude Desktop / MCPクライアントでの使用方法

MCPクライアントの設定（例: Claude Desktopのclaude_desktop_config.json）に以下を追加してください：

{
  "mcpServers": {
    "postgres": {
      "command": "uv",
      "args": [
        "run",
        "/path/to/2025postgresqlmcp/main.py"
      ],
      "env": {
        "DATABASE_URL": "postgres://user:password@localhost:5432/mydatabase"
      }
    }
  }
}