Rathoddarshil MCP Postgres Query Server

🚀 MCP PostgreSQLクエリサーバ

このプロジェクトは、読み取り専用モードでPostgreSQLデータベースをクエリするためのMCPプロトコル（Model Context Protocol）サーバの実装です。Claude Desktopやその他のMCPクライアント向けに設計されています。

🚀 クイックスタート

このサーバを使用することで、安全にPostgreSQLデータベースを読み取り専用でクエリでき、Claude Desktopとシームレスに統合できます。

✨ 主な機能

• 安全で読み取り専用のアクセス：PostgreSQLデータベースに安全な読み取り専用アクセスを提供します。
• MCPプロトコルとの統合：Claude DesktopとMCPプロトコルを通じて統合されます。
• SQLクエリ検証：SELECTクエリのみを実行するようにクエリを検証します。
• クエリタイムアウト保護：クエリが10秒以内に完了しない場合、自動的にタイムアウトします。

📦 インストール

前提条件

• Node.js (v14以上)
• npm（Node.jsに付属）
• PostgreSQLデータベース（コマンドラインで提供される接続詳細）

インストール手順

# リポジトリをクローン
git clone https://github.com/RathodDarshil/mcp-postgres-query-server.git
cd mcp-postgres-query-server

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

📚 ドキュメント

Claude Desktopとの接続

Claude Desktopを自動的に起動し、MCPサーバに接続するように設定できます。

1. Claude Desktopの設定ファイルにアクセスします。

   • Claude Desktopを開きます。
   • 設定 > 開発者 > 設定を編集 を選択します。
   • これにより、デフォルトのテキストエディタで設定ファイルが開きます。

2. claude_desktop_config.jsonのmcpServersセクションにpostgres-query-serverを追加します。

{
    "mcpServers": {
        "postgres-query": {
            "command": "node",
            "args": [
                "/path/to/your/mcp-postgres-query-server/dist/index.js",
                "postgresql://username:password@hostname:port/database"
            ]
        }
    }
}

3. /path/to/your/を実際のプロジェクトディレクトリのパスに置き換えます。
4. PostgreSQLの接続文字列の実際のデータベース資格情報を置き換えます。
5. ファイルを保存し、Claude Desktopを再起動します。MCPサーバが設定のMCPサーバ選択ドロップダウンメニューに表示されるはずです。

設定例

以下は、postgres-queryを含む完全な設定ファイルの例です。

{
    "mcpServers": {
        "postgres-query": {
            "command": "node",
            "args": [
                "/path/to/mcp-postgres-query-server/dist/index.js",
                "postgresql://user:password@localhost:5432/mydatabase"
            ]
        }
    }
}

機能の詳細

• 読み取り専用アクセス：サーバはSELECTクエリのみを実行することを許可し、データベースへの書き込み操作を防止します。
• タイムアウト保護：すべてのクエリが10秒以内に完了しない場合、クエリは中止され、長時間のブロッキングを防止します。
• 安全な接続：SSLによる暗号化通信がデフォルトで有効になっています。

使用方法

1. サーバのビルド：依存関係をインストールし、npm run buildを実行します。
2. PostgreSQL接続の設定：dist/index.jsのデータベース接続文字列を環境に合わせて変更します。
3. サーバの起動：ターミナルでnode dist/index.jsを実行します。
4. Claude Desktopでの使用：Claude Desktopを再起動した後、新しく追加したMCPサーバを選択してクエリを実行します。

拡張機能

• ログ記録：リクエストとレスポンスを追跡するためのログを追加できます。
• エラーハンドリング：エラーハンドリングロジックを強化し、より詳細なエラー情報を提供できます。
• 接続プールの最適化：PostgreSQL接続プールのパラメータを調整してパフォーマンスを向上させることができます。

セキュリティに関する注意事項

• コード内に資格情報をハードコードせず、環境変数または安全なシークレット管理ツールを使用してください。
• サーバが信頼できるネットワーク環境で実行されていることを確認し、不正アクセスを防止してください。
• 既知のセキュリティホールを防ぐために、依存関係を定期的に更新してください。

以上の手順に従うことで、Claude Desktopやその他のMCPクライアントとシームレスに統合される、安全で効率的なPostgreSQLクエリサーバを簡単に設定できます。