Postgresql Products MCP Server

🚀 PostgreSQL 產品 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，用於與包含產品信息的 PostgreSQL 數據庫進行交互。它支持客戶端（如 AI 助手）通過 SQL 查詢數據庫，為數據交互提供了便捷的途徑。

🚀 快速開始

本服務器基於 Model Context Protocol (MCP)，可與 PostgreSQL 數據庫交互，客戶端（如 AI 助手）能使用 SQL 查詢數據庫。以下是使用該服務器的詳細步驟。

✨ 主要特性

• 基於 MCP 協議，實現與 PostgreSQL 數據庫的交互。
• 支持客戶端使用 SQL 查詢數據庫。
• 提供 run_sql_query 工具，可執行只讀 SQL 查詢（僅限 SELECT 語句）。

📦 安裝指南

先決條件

• Node.js（推薦 v18 或更高版本）
• npm 或 yarn
• 具有 products 模式的 PostgreSQL 數據庫訪問權限。

安裝步驟

1. 克隆此倉庫（或下載源代碼）：

   git clone https://github.com/michael7736/postgres-mcp-server.git
   cd postgres-mcp-server
   

2. 安裝依賴項：

   npm install
   # 或者
   yarn install
   

構建

將 TypeScript 代碼編譯為 JavaScript：

npm run build
# 或者
yarn build

這將在 build/ 目錄中創建可執行文件（build/index.js）。

配置

此服務器需要通過環境變量提供 PostgreSQL 連接詳細信息，這些信息在您的 MCP 客戶端設置中配置時會用到（例如 cline_mcp_settings.json 或 claude_desktop_config.json）。

所需的環境變量包括：

• PGHOST：PostgreSQL 服務器的主機名。
• PGPORT：PostgreSQL 服務器的端口號（默認：5432）。
• PGUSER：數據庫連接的用戶名。
• PGPASSWORD：數據庫連接密碼。
• PGDATABASE：要連接到的數據庫名稱。

示例 MCP 設置配置：

{
  "mcpServers": {
    "postgres-products": {
      "command": "node",
      "args": ["/path/to/your/postgres-mcp-server/build/index.js"],
      "env": {
        "PGHOST": "your_db_host",
        "PGPORT": "5432",
        "PGUSER": "your_db_user",
        "PGPASSWORD": "your_db_password",
        "PGDATABASE": "your_db_name"
      },
      "disabled": false, // 確保已啟用
      "autoApprove": [] // 配置自動批准如果需要
    }
    // ... 其他服務器
  }
}

請將 /path/to/your/postgres-mcp-server/build/index.js 替換為您系統上實際構建文件的路徑，並在 env 部分填寫您的具體數據庫憑據。

💻 使用示例

基礎用法

配置完成後並通過您的 MCP 客戶端運行此服務器，該服務器提供以下工具：

run_sql_query

執行針對配置的產品數據庫的只讀 SQL 查詢（僅限 SELECT 語句）。

輸入模式：

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "要執行的 SQL 選擇查詢。"
    }
  },
  "required": ["query"]
}

示例工具調用：

<use_mcp_tool>
  <server_name>postgres-products</server_name>
  <tool_name>run_sql_query</tool_name>
  <arguments>
  {
    "query": "SELECT product_name, stock_quantity FROM products WHERE category = 'Electronics';"
  }
  </arguments>
</use_mcp_tool>