MCP Server Postgres

🚀 PostgreSQL モデルコンテキストプロトコル（PG - MCP）サーバー

PostgreSQLデータベース用に設計された、AIエージェント機能を強化するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、AIエージェントがPostgreSQLデータベースを効果的に発見、接続、クエリ、理解するためのAPIを提供します。

🚀 クイックスタート

PG - MCPは、モデルコンテキストプロトコルをPostgreSQLデータベース上で完全に実装したサーバーです。MCPのリソース指向アーキテクチャを通じて、AIエージェントにPostgreSQLデータベースを操作するための包括的なAPIを提供します。

✨ 主な機能

接続管理

• Connect ツール：PostgreSQL接続文字列の登録と安全な接続IDの取得
• Disconnect ツール：データベース接続の明示的な切断
• 接続プール：効率的な接続管理

クエリツール

• pg_query：接続IDを使用して読み取り専用のSQLクエリを実行
• pg_explain：クエリ実行計画を分析し、JSON形式で結果を返す

モデルコンテキストプロトコル（MCP）サーバーのアーキテクチャ

このサーバーは以下のコンポーネントに基づいて構築されています。

• MCP：モデルコンテキストプロトコルの基礎
• FastMCP：MCP用のPythonライブラリ
• asyncpg：非同期PostgreSQLクライアント
• YAML：拡張コンテキスト情報に使用

また、この実装は参考PostgreSQL MCP実装をベースに拡張されており、以下の主要な強化機能を備えています。

1. 完全なサーバー実装：本番環境で使用できるSSE伝送用の完全なサーバー
2. 複数データベースのサポート：複数のPostgreSQLデータベースに同時に接続
3. 豊富なカタログ情報：データベースカタログ内のテーブル/列の説明を抽出して公開
4. 拡張コンテキスト：PostGISやpgvectorなどのPostgreSQL拡張に関する詳細なYAML形式の知識を提供
5. クエリ解釈：クエリ実行計画を分析するための専用ツールを内蔵
6. 堅牢な接続管理：完全な接続ライフサイクル管理と安全な接続ID処理

📦 インストール

前提条件

• Python 3.13+
• PostgreSQLデータベース

Dockerを使用する場合

# リポジトリをクローン
git clone https://github.com/stuzero/pg-mcp.git
cd pg-mcp

# Docker Composeで構築して実行
docker-compose up -d

手動インストール

# リポジトリをクローン
git clone https://github.com/stuzero/pg-mcp.git
cd pg-mcp

# 仮想環境を作成してアクティブ化
python -m venv .venv
source .venv/bin/activate  # Windowsユーザーは：.venv\Scripts\activate を使用
# uvを使ってインストール
uv sync --frozen

# サーバーを起動
python -m server.app

💻 使用例

サーバー機能のテスト

リポジトリには、サーバー機能を検証するためのテストスクリプトが含まれています。

# 基本的なサーバー機能のテスト
python test.py "postgresql://username:password@hostname:port/database"

# Claudeを使用して自然言語をSQLに変換
python client/claude_cli.py "Show me the top 5 customers by total sales"