Postgresql MCP Server P15

🚀 PostgreSQL MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を通じて、ユーザーがPostgreSQLデータベースに接続できるようにするものです。MCPプロトコルを介して、PostgreSQLデータベースとのインタラクションに必要なリソース、ツール、およびヒントを公開します。

🚀 クイックスタート

このMCPサーバーを使用することで、外部アプリケーションはPOSTリクエストを介してデータベースの認証情報をSSE（サーバー送信イベント）エンドポイントに共有できます。その後、サーバーは指定されたPostgreSQLデータベースへの接続を確立し、様々な方法でデータベースとのインタラクションを提供します。

✨ 主な機能

リソース

クエリ履歴

• メモリストレージ：開発中に使用されます。
• Redis ストレージ：REDIS_URL が提供された本番環境で使用されます。

ツール

1. クエリ生成：
   • 説明に基づいてSQLクエリを生成します。
   • パラメータ：説明、テーブル名、データベースタイプ（デフォルト値：'postgresql'）
2. クエリ分析：
   • SQLクエリのパフォーマンスと問題を分析します。
   • パラメータ：クエリ、データベースタイプ（デフォルト値：'postgresql'）
3. スキーマ解説：
   • データベーススキーマを自然言語で説明します。
   • パラメータ：スキーマJSON

🔧 技術詳細

サーバーはモジュール化されたアーキテクチャを採用しており、以下のように明確な役割分担がされています。

• サーバーコア - MCPプロトコルの実装と調整を処理します。
• リソース - データベースエンティティのデータとメタデータを提供します。
• ツール - データベース操作（クエリ、接続、テーブル管理）を実装します。
• ヒント - 自然言語処理のヒントを提供します。

📦 インストール

環境変数

📚 ドキュメント

APIエンドポイント

リソース関連

• GET /api/stats：データベースの統計情報を取得します。
• POST /api/query：クエリを実行します。
• DELETE /api/clear-history：クエリ履歴をクリアします。

💻 使用例

MCPインスペクターでのテスト

MCPインスペクター を使用してサーバーをテストするには、以下のコマンドを実行します。

# MCPインスペクターをインストールする
npm install -g @modelcontextprotocol/inspector

# インスペクターを起動する
mcp-inspector --server-url http://localhost:3000

🤝 コントリビューション

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。