Go MCP Postgres

🚀 go-mcp-postgres

本項目從 https://github.com/Zhwt/go-mcp-mysql/ 複製代碼，並藉助 AI 將數據庫從 MySQL 改為 PostgreSQL。可直接使用 Model Context Protocol (MCP) 服務器與 Postgres 及自動化功能交互，無需 Node.js 或 Python 環境。該服務器提供對 Postgres 數據庫和表的 CRUD 操作工具，還有隻讀模式防止意外寫入。還能通過添加 --with-explain-check 標誌，讓 MCP 服務器在執行查詢前用 EXPLAIN 語句檢查查詢計劃。

🚀 快速開始

本項目仍在開發中，可能還不適用於生產環境。使用前請確保 PostgreSQL 服務已正確安裝並運行，同時採用強密碼策略增強安全性，定期備份數據庫以防數據丟失。

✨ 主要特性

• 可直接使用 MCP 服務器與 Postgres 及自動化功能交互，無需 Node.js 或 Python 環境。
• 提供對 Postgres 數據庫和表的 CRUD 操作工具。
• 具備只讀模式，可防止意外寫入操作。
• 可通過添加 --with-explain-check 標誌，在執行查詢前使用 EXPLAIN 語句檢查查詢計劃。

📦 安裝指南

方式一：下載發佈版本

獲取最新 發佈版本 並將其放入您的 $PATH 或其他易於訪問的位置。

方式二：從源代碼構建

若您已經安裝了 Go，可以直接從源代碼構建：

go install -v github.com/guoling2008/go-mcp-postgres@latest

💻 使用示例

基礎用法

方法 A：使用命令行參數進行 stdio 模式

{
  "mcpServers": {
    "postgres": {
      "command": "go-mcp-postgres",
      "args": [
        "--dsn",
        "postgresql://user:pass@host:port/db"
      ]
    }
  }
}

方法 B：使用命令行參數進行交互式模式

# 連接 PostgreSQL 數據庫
go-mcp-postgres postgresql://user:password@host:port/db

高級用法

在執行查詢前，可添加 --with-explain-check 標誌，使 MCP 服務器使用 EXPLAIN 語句檢查查詢計劃。

📚 詳細文檔

工具說明

數據庫連接

• --dsn 或 -d：指定數據庫連接字符串。
• --driver 或 -D：指定數據庫驅動（默認為 postgres）。

常用命令

• \help：顯示所有可用命令。
• \list：列出所有數據庫。
• \tables：列出當前數據庫中的表。
• \schema：顯示錶結構。
• \exit 或 \q：退出程序。

工具功能

數據庫操作

• 創建數據庫：

CREATE DATABASE database_name;

• 刪除數據庫：

DROP DATABASE database_name;

• 使用數據庫：

\c database_name;

表操作

• 創建表：

CREATE TABLE table_name (
  column1 datatype,
  column2 datatype,
  ...
);

• 刪除表：

DROP TABLE table_name;

• 插入數據：

INSERT INTO table_name (column1, column2, ...)
VALUES (value1, value2, ...);

• 更新數據：

UPDATE table_name
SET column1 = new_value1,
    column2 = new_value2,
    ...
WHERE condition;

• 刪除數據：

DELETE FROM table_name
WHERE condition;

• 查詢數據：

SELECT column1, column2, ...
FROM table_name
[WHERE condition];

權限管理

• 授予訪問權限：

GRANT ALL PRIVILEGES ON DATABASE database_name TO username;

• 撤銷訪問權限：

REVOKE ALL PRIVILEGES ON DATABASE database_name FROM username;

📄 許可證

本項目採用 MIT 許可證。