Postgres

🚀 Postgres MCP（研究プロジェクト）

このプロジェクトは、PostgreSQLデータベース用に実装されたModel Control Protocol (MCP) サーバーです。簡単なHTTPインターフェースを提供し、MCPを通じてPostgreSQLデータベースとやり取りできます。読み取り専用のクエリを実行し、データベースリソースを探索することが可能です。

🚀 クイックスタート

Postgres MCPは、PostgreSQLデータベースとMCPを介してやり取りするためのHTTPサーバーです。以下の手順でサーバーを起動し、データベースリソースを探索できます。

✨ 主な機能

• MCPプロトコルに準拠したHTTPサーバー
• 読み取り専用のSQLクエリ実行
• データベースリソースの一覧表示
• .envファイルを使用した環境変数のサポート
• Go言語とGin Webフレームワークを使用して構築

📦 インストール

必要条件

• Go 1.23.6以上
• PostgreSQLデータベース
• Git

インストール手順

git clone https://github.com/ipfans/postgres-mcp.git
cd postgres-mcp
go mod download

📚 ドキュメント

設定

データベース接続は、以下の2つの方法で設定できます。

コマンドライン引数を使用する場合

go run cmd/postgres-mcp/main.go -db "postgres://user:password@localhost:5432/dbname"

環境変数を使用する場合

• プロジェクトのルートディレクトリに.envファイルを作成します。
• 以下のようにデータベースURLを追加します。

DATABASE_URL=postgres://user:password@localhost:5432/dbname

使用方法

サーバーの起動

go run cmd/postgres-mcp/main.go

サーバーはデフォルトのポート8080で起動します。

MCPエンドポイントとのやり取り

データベースリソースの一覧表示

POST http://localhost:8080/mcp
Content-Type: application/json

{
    "type": "function",
    "name": "resources"
}

読み取り専用クエリの実行

POST http://localhost:8080/mcp
Content-Type: application/json

{
    "type": "function",
    "name": "query",
    "arguments": {
        "query": "SELECT * FROM your_table LIMIT 10"
    }
}

📄 ライセンス

このプロジェクトはオープンソースで、MITライセンスの下で提供されています。

🔗 貢献

貢献を歓迎します！自由にプルリクエストを送信してください。