MCP Postgres Full Access

🚀 PostgreSQL 全文翻譯說明

這個 MCP（機器學習平臺）服務器是一個用於連接 PostgreSQL 數據庫的自定義工具，它支持讀寫操作，還提供了增強的數據庫交互功能，能讓用戶更高效、安全地與 PostgreSQL 數據庫進行交互。

✨ 主要特性

1. 增強的數據庫訪問

• 讀寫支持：支持用戶執行 SELECT、INSERT、UPDATE 和 DELETE 操作，滿足多樣化的數據操作需求。
• 權限控制：通過創建專用數據庫用戶並授予適當權限，確保安全連接到 PostgreSQL 數據庫。示例如下：

-- 創建一個受限用戶（根據需要進行調整）
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;
-- 只授予必要的權限

2. 增強的數據庫交互

• 事務支持：用戶可以使用 commit 和 rollback 命令來管理事務，保證數據操作的一致性和完整性。

# 提交事務
commit

# 回滾事務
rollback

• 索引信息：可顯示指定表的索引及其類型，方便用戶瞭解表的索引結構。

\di+ table_name

• 外鍵信息：展示特定表的外鍵關聯，幫助用戶理清表之間的關係。

\d+ table_name

• 行估計：提供表的大小和行數統計信息，讓用戶對錶的數據規模有清晰的認識。

# 表大小和行數統計
\dt+

• 表描述：顯示錶及其列的詳細信息，包括數據類型和約束，便於用戶瞭解表的結構。

\d table_name

3. 安全注意事項

• 始終使用“允許一次”選項，每次寫入操作前仔細審查 SQL 語句：
  • 查看錶名、確認列名和數據準確性。
  • 確保 WHERE 子句適當，避免誤刪或誤更新。

💻 使用示例

基礎用法

示例 1：創建新表並添加數據

用戶："我需要一個包含 id、名稱、價格和庫存的新產品表。" Claude：分析你的數據庫需求，生成以下 SQL 語句：

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

用戶：審查後點擊“允許一次”。 Claude：“我已經創建了 products 表。是否需要添加一些示例數據？” 用戶："是的，請添加五個示例產品。" Claude：生成 INSERT 語句並提示批准。

高級用法

示例 2：安全工作流程

對於任何寫入操作，採用兩步驗證：

1. 分析請求：Claude 根據你的需求準備 SQL。
2. 讀取操作自動執行：僅 SELECT 查詢會直接運行。
3. 寫入操作處理：
   • Claude 在事務中執行 SQL 並結束對話。
   • 用戶審查結果。
   • 新對話中，用戶回覆“是”提交或“否”回滾。

📦 安裝指南

構建與運行容器

# 構建 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 run -i --rm mcp-postgres-full-access "postgresql://username:password@host.docker.internal:5432/database"

📄 許可證

此 MCP 服務器根據 MIT License 分發。

創建者

由 Syahiid Nur Kamil（@syahiidkamil）創建。

版權所有 © 2024 Syahiid Nur Kamil。保留所有權利。