Postgres MCP Server

🚀 PostgreSQL MCP 服務器（模型上下文協議）

本項目實現了快速 MCP（Model Context Protocol）的基本版本，可直接與 PostgreSQL 數據庫進行交互。藉助該 MCP，能將 AI 聊天體驗拓展至多個應用場景，如在 PostgreSQL 數據庫中存儲和檢索聊天數據、利用持久化數據存儲創建 AI 應用程序、構建基於結構化數據庫查詢的知識管理系統、通過自然語言提示直接分析大數據集，以及實現不依賴傳統編碼的基於數據庫的工作流程。此外，該實現利用 MCP 協議，安全地將 Claude AI 與 PostgreSQL 數據庫連接起來，在執行操作時能維護適當的隔離和安全邊界。

🚀 快速開始

本項目可幫助您藉助 MCP 協議實現與 PostgreSQL 數據庫的交互，以及與 Claude AI 的集成。以下為您介紹使用前的準備工作和操作步驟。

✨ 主要特性

• 數據庫查詢：可執行對 PostgreSQL 數據庫的查詢操作。
• 表管理：支持表的創建與刪除操作。
• 數據操作：涵蓋數據的選擇、插入、更新和刪除操作。
• 架構檢查：能夠檢查數據庫架構。
• Claude 集成：可通過 MCP 協議與 Claude AI 集成。

📦 安裝指南

克隆倉庫

將此倉庫克隆到本地計算機。

創建並激活 Python 虛擬環境

# 創建虛擬環境
python -m venv .mcp

# 激活虛擬環境
# 在 macOS/Linux 上
source .mcp/bin/activate
# 在 Windows 上
.mcp\Scripts\activate

安裝所需依賴項

pip install -r requirements.txt

📚 詳細文檔

配置

配置 .env 文件

在項目根目錄中創建一個 .env 文件，其中包含您的 PostgreSQL 連接詳細信息和調試信息。

配置 Claude AI

通過將以下配置添加到 Claude AI 應用程序設置的 MCP 配置部分，使用 Claude 配置 PostgreSQL MCP 服務器：

{
  "mcpServers": {
    "PostgreSQL MCP": {
      "command": "<實際路徑>/.mcp/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "asyncpg",
        "--with",
        "httpx",
        "--with",
        "python-dotenv",
        "--with",
        "psycopg2-binary",
        "mcp",
        "run",
        "<實際路徑>/postgres_mcp_server.py"
      ],
      "env": {
        "POSTGRES_HOST": "<您的 PostgreSQL 主機>",
        "POSTGRES_PORT": "<您的 PostgreSQL 端口>",
        "POSTGRES_USER": "<您的用戶名>",
        "POSTGRES_PASSWORD": "<您的密碼>",
        "POSTGRES_DB": "<您的數據庫名稱>"
      }
    }
  }
}

⚠️ 重要提示

請將“<實際路徑>”替換為實際路徑，並將此配置添加到 Claude AI 應用程序設置的 MCP 配置部分，這樣 Claude 才能連接到您的 PostgreSQL MCP 服務器。