Postgresql Model Context Protocol (pg Mcp) Server 7fh

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

PostgreSQL データベース向けに設計された、AI エージェントによる機能強化を持つモデルコンテキストプロトコル (MCP) サーバーです。

pg - mcp プロジェクトに関する詳細情報は、以下を参照してください：

https://stuzero.github.io/pg - mcp/

🚀 クイックスタート

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

この実装は 参考 PostgreSQL MCP 実装 をベースに拡張されており、いくつかの重要な機能強化が施されています。

✨ 主な機能

接続管理

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

クエリツール

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

スキーマ発見リソース

• スキーマとその説明の一覧表示
• テーブルとその説明、行数の一覧表示
• 列の詳細情報（データ型、説明など）の取得
• テーブルの制約とインデックスの確認
• データベース拡張機能の探索

データアクセスリソース

• テーブルのサンプルデータ（ページング付き）
• 概算行数の取得

拡張コンテキスト

PostgreSQL 拡張機能に関する組み込みのコンテキスト情報があります。例えば：

• PostGIS：空間データ型、関数、サンプル
• pgvector：ベクトル類似性検索機能とベストプラクティス

その他の拡張機能は YAML 設定ファイルで簡単に追加できます。

📦 インストール

前提条件

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

Docker を使用する場合

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

# Docker Compose を使用したビルドと実行
docker - compose up -d

手動インストール

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

# 依存関係のインストールと仮想環境の作成（.venv）
uv sync

# 仮想環境のアクティブ化
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

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

💻 使用例

インストール後の使用方法

1. サーバーの起動：

python -m server.app

2. API ドキュメントの参照： ブラウザを開き、http://localhost:8000/docs にアクセスして、対話型 API ドキュメントを確認します。

3. コマンドラインツールの使用： pg_query と pg_explain コマンドを使用してデータベースとやり取りします。

基本的な使用法

# クエリの実行
pg_query -H localhost -P 5432 -U postgres -d testdb -q "SELECT * FROM users LIMIT 10;"

# 実行計画の分析
pg_explain -H localhost -P 5432 -U postgres -d testdb -q "SELECT COUNT(*) FROM orders;"

🔧 技術詳細

PG - MCP サーバーは階層型アーキテクチャで設計されており、主なコンポーネントは以下の通りです：

• Web サービス：FastAPI をベースにした RESTful API の実装
• データベースアダプター：PostgreSQL の接続プールとトランザクション管理のサポート
• クエリインタープリター：PostgreSQL 実行計画分析ツールの統合
• ドキュメント生成：API ドキュメント（Swagger など）の自動生成

📚 ドキュメント

参考資料

1. FastAPI 公式ドキュメント
2. PostgreSQL 公式ドキュメント
3. モデルコンテキストプロトコル (MCP) 仕様