MEC Postgres

🚀 MEC PostgreSQL 服務器

MEC PostgreSQL 服務器是一個模型上下文協議（Model Context Protocol）服務器，它提供了對 PostgreSQL 數據庫的讀寫訪問能力。藉助該服務器，大型語言模型（LLM）能夠檢查數據庫架構，並執行讀取和寫入查詢操作。

🚀 快速開始

若要使用此服務器與 Claude Desktop 應用，需將以下配置添加到 claude_desktop_config.json 文件中的 "mcpServers" 部分：

Docker

• 當在 macOS 上運行 docker 時，請使用 host.docker.internal 如果服務器運行在主機網絡（例如 localhost）。
• 用戶名/密碼可以添加到 PostgreSQL URL 中，格式為 postgresql://user:password@host:port/db-name。

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"]
    }
  }
}

請將 /mydb 替換為您的數據庫名稱。

✨ 主要特性

• 提供對 PostgreSQL 數據庫的讀寫訪問。
• 支持大型語言模型（LLM）檢查數據庫架構並執行查詢。
• 提供每個表的架構信息。

📦 安裝指南

Docker 構建

使用以下命令構建 Docker 鏡像：

docker build -t mcp/postgres -f src/postgres/Dockerfile . 

💻 使用示例

工具使用

query

• 功能：執行針對連接到的數據庫的只讀 SQL 查詢。
• 輸入：sql (字符串)：要執行的 SQL 查詢。
• 說明：所有查詢都在 READ ONLY（只讀）事務中執行。

uploadCsv

• 功能：上傳並處理 CSV 文件到數據庫表中。
• 輸入：sql (字符串)：要執行的 SQL 查詢。
• 說明：所有查詢都在 READ AND WRITE（讀寫）事務中執行。

資源獲取

該服務器提供每個表的架構信息，可通過以下鏈接獲取：

• 表架構 (postgres://<host>/<table>/schema)
  • 每個表的 JSON 架構信息。
  • 包括列名和數據類型。
  • 自動從數據庫元數據中發現。

📚 詳細文檔

使用 Claude Desktop 注意事項

• 當在 macOS 上運行 docker 時，請使用 host.docker.internal 如果服務器運行在主機網絡（例如 localhost）。
• 用戶名/密碼可以添加到 PostgreSQL URL 中，格式為 postgresql://user:password@host:port/db-name。

配置文件說明

在 claude_desktop_config.json 文件的 "mcpServers" 部分添加如下配置：

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://host.docker.internal:5432/mydb"]
    }
  }
}

需將 /mydb 替換為您的數據庫名稱。

📄 許可證

此 MCP 服務器根據 MIT License（MIT 許可證）發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。如需瞭解詳細信息，請參閱項目存儲庫中的 LICENSE 文件。