Rathoddarshil MCP Postgres Query Server

🚀 MCP PostgreSQL 查詢服務器

這是一個專為Claude Desktop和其他MCP客戶端打造的MCP協議（Model Context Protocol）服務器實現，可在只讀模式下對PostgreSQL數據庫進行查詢，為數據查詢提供了安全且高效的解決方案。

🚀 快速開始

該項目實現了安全、只讀地訪問PostgreSQL數據庫，能與Claude Desktop通過MCP協議集成，還具備SQL查詢驗證和查詢超時保護功能。

✨ 主要特性

• 只讀訪問：服務器僅允許執行SELECT查詢，防止對數據庫的寫操作。
• 超時保護：所有查詢在10秒內未完成將被終止，防止長時間阻塞。
• 安全連接：通過SSL加密通信，默認啟用。

📦 安裝指南

先決條件

• 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

💻 使用示例

基礎用法

1. 構建服務器

安裝依賴並運行npm run build。

2. 配置PostgreSQL連接

修改dist/index.js中的數據庫連接字符串以匹配您的環境。

3. 啟動服務器

在終端中運行node dist/index.js。

4. 在Claude Desktop中使用

重啟Claude Desktop後，選擇新添加的MCP服務器進行查詢。

高級用法

與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"
            ]
        }
    }
}

📚 詳細文檔

擴展

• 日誌記錄：添加日誌以跟蹤請求和響應。
• 錯誤處理：增強錯誤處理邏輯，提供更詳細的錯誤信息。
• 連接池優化：調整PostgreSQL連接池參數以提高性能。

安全注意事項

• 避免在代碼中硬編碼憑據，使用環境變量或安全的秘密管理工具。
• 確保服務器運行在受信任的網絡環境中，防止未授權訪問。
• 定期更新依賴以防範已知的安全漏洞。

通過以上步驟，您可以輕鬆設置一個安全、高效的PostgreSQL查詢服務器，與Claude Desktop或其他MCP客戶端無縫集成。