MCP Postgres Full Access Extended

🚀 PostgreSQL 全訪問 MCP 服務器

PostgreSQL 全訪問 MCP（機器學習平臺）服務器是一款強大的工具，它能讓你對 PostgreSQL 數據庫進行全面的讀寫操作。同時，它還具備諸多高級功能，如提供詳細的 schema 信息、支持事務處理、展示索引與外鍵詳情等，為數據庫管理帶來極大便利。

✨ 主要特性

概述

PostgreSQL 全訪問 MCP 服務器可對 PostgreSQL 數據庫進行完全訪問，涵蓋讀取和寫入操作，還提供增強的 schema 細節、事務支持、索引信息、外鍵細節、行估計數、表描述等高級功能。

核心特性

• 讀寫訪問：支持 SELECT、INSERT、UPDATE、DELETE 等各類數據庫操作。
• 增強型 Schema 詳情：提供詳盡的表結構信息，包含索引和外鍵關係。
• 事務支持：可顯式控制事務，具備超時機制保障數據一致性。
• 索引與外鍵信息：展示表的索引和外鍵細節。
• 行數量估計：對錶中記錄數進行估算。
• 表描述：包含每個表的詳細描述信息。

優勢

相較於官方 PostgreSQL MCP 服務器，本服務器功能更全面，支持更多高級操作，且提供更詳細的數據庫元數據。

📦 安裝指南

使用 Docker 運行

# 構建 Docker 鏡像
docker build -t mcp-postgres-full-access .

# 啟動容器
docker run -i --rm mcp-postgres-full-access "postgresql://username:password@host:5432/database"

⚠️ 重要提示

在 macOS 系統上，使用 host.docker.internal 代替主機名以連接到 Docker 容器的網絡。

💻 使用示例

基礎用法

創建新表並添加數據

用戶: "我需要創建一個包含 id、名稱、價格和庫存的新產品表"

Claude: 分析數據庫並生成查詢

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price DECIMAL(10,2) NOT NULL,
    inventory INTEGER DEFAULT 0
);

用戶: 審核後點擊“允許一次”

Claude: "我已經創建了產品表。是否需要添加一些示例數據？"

用戶: "是的，請添加5條示例產品數據"

Claude: 生成插入語句並請求批准 用戶審核後點擊“允許一次”

數據分析（只讀操作）

用戶: "請告訴我價格最高的3款產品是什麼？"

Claude: 執行只讀查詢並顯示結果

🔒 安全注意事項

數據庫用戶權限

⚠️ 重要提示

使用一個受限的數據庫用戶，並授予其必要的最小權限。

-- 示例：創建受限用戶（根據需要進行調整）
CREATE USER claude_user WITH PASSWORD 'secure_password';
GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;
GRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;
-- 根據需求授予特定權限

使用最佳實踐

💡 使用建議

1. 始終使用“允許一次”：在執行寫入操作前，仔細審核每條指令。永遠不要選擇“總是允許”，除非你已充分驗證過代碼。
2. 連接到測試數據庫：初次使用時，請鏈接到一個測試或備份數據庫。
3. 謹慎處理敏感數據：確保數據庫中的敏感信息得到妥善保護。

📚 詳細文檔

功能模塊

1. PostgreSQL 全訪問功能
   • 支持完整的 SQL 查詢，包括 DDL 和 DML 操作。
   • 提供詳細的查詢結果和執行計劃。
2. 增強型 Schema 信息
   • 顯示錶結構、索引、外鍵等詳細信息。
   • 支持自動生成數據庫文檔。
3. 事務控制
   • 允許顯式開始和提交事務。
   • 設置超時機制以防止死鎖和其他併發問題。
4. 性能優化工具
   • 提供查詢執行計劃分析。
   • 顯示錶空間使用情況和索引統計信息。

安裝與配置

快速安裝

# 使用 Docker 啟動 MCP 服務器
docker run -d --name mcp-server -p 5000:5000 mcr.microsoft.com/mssql-tools:latest

配置選項

• 端口映射：默認使用 5000 端口。
• 環境變量配置：

docker run -e PGPORT=5432 -e PGUSER=username -e PGPASSWORD=password ...

使用教程

創建新數據庫

CREATE DATABASE my_database;
\c my_database;  -- 切換到新數據庫

管理用戶與權限

CREATE USER new_user WITH PASSWORD 'securepass';
GRANT ALL PRIVILEGES ON DATABASE my_database TO new_user;

示例查詢

-- 查詢所有產品及其價格
SELECT * FROM products ORDER BY price DESC;

-- 插入新記錄
INSERT INTO products (name, price, inventory) VALUES ('New Product', 99.99, 10);

安全與合規

數據加密

• 傳輸中加密：確保所有數據庫連接使用 SSL 加密。
• 數據-at-rest 加密：對存儲的數據進行加密，防止物理盜竊。

審計日誌

• 記錄所有用戶操作和查詢歷史。
• 配置審核策略以監控敏感操作。

符合法規

• 確保遵守 GDPR、HIPAA 等數據保護法規。
• 定期進行安全審計和漏洞掃描。

常見問題

為什麼需要增強型 Schema 信息？

• 回答：增強型 Schema 信息有助於更好地理解數據庫結構，優化查詢性能，並生成文檔。

如何處理大事務？

• 解答：建議將長事務分解為多個小事務，並定期提交以避免鎖定問題。

總結

PostgreSQL 全訪問 MCP 服務器功能全面，適用於需要完全控制和詳細信息的數據庫管理場景。通過 Docker 容器化部署，可輕鬆集成到現有環境中，同時保障安全性和性能優化。