GaussDB Read-Only MCP

io.github.gxc由 GitHub 帳號 gxc 發布v0.3.0更新於 Oct 24, 2026

Read-only MCP server for Huawei GaussDB (centralized & distributed), built for coding agents.

發布方自己的服務：OnlyMCP

已驗證STDIO僅桌面資料庫開發者工具

概覽

AI 產生的概覽

針對華為 GaussDB 的唯讀 MCP 伺服器，讓編碼助理安全檢視結構、資料表、索引並執行單一 SELECT 查詢。

可以做什麼
  • 測試與已設定 GaussDB 執行個體的連線，回傳版本、目前資料庫/使用者、唯讀狀態與延遲
  • 列出結構清單，含物件數與註解，可選擇是否包含系統結構
  • 列出資料表與檢視表，含類型、預估列數與註解，可依結構篩選
  • 檢視資料表結構：欄位、主鍵與限制條件、全部索引定義；檢視表回傳定義 SQL，分割表回傳分割清單
  • 執行單一 SELECT 或 WITH 查詢，受列數與逾時限制，回傳欄位名稱、資料列與是否截斷
適用情境
適合編碼助理在不承擔寫入風險的情況下探查 GaussDB（集中式或分散式）資料庫，尤其是正式環境或內網執行個體。主要用於結構探索與臨時查詢，而非資料修改或維運管理。
執行需求
以本機靜態二進位檔執行（Homebrew、下載發行檔或自行編譯），透過 stdio 通訊，不需要 Node.js 等執行環境。需要一個 YAML 設定檔，透過 -config 參數、環境變數 GAUSSDB_RO_MCP_CONFIG 或預設路徑定位，內容填寫一個或多個執行個體的主機、連接埠、資料庫、使用者名稱與密碼。需要能連線到 GaussDB 伺服器的網路；預設關閉 SSL 以配合內網環境。
安裝前請注意
設定檔以明文保存資料庫密碼，需妥善保護。預設關閉 SSL，憑證與查詢結果在網路上未加密傳輸。服務本身為唯讀，但仍會向實際資料庫送出查詢；建議依 README 使用僅具 SELECT 權限的最小權限帳號。它無法連線原生 PostgreSQL，只能連線 GaussDB 或 openGauss。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 GaussDB Read-Only MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

gaussdb-ro-mcp

[简体中文] | English

[CI] [Glama] [Release] [License]

[!NOTE] English: A read-only MCP server for Huawei GaussDB (centralized & distributed), built for coding agents (Claude Code, OpenCode, etc.). Three layers of read-only enforcement — static SQL validation, server-side READ ONLY transactions, and least-privilege account guidance — in a single static binary designed for non-SSL intranet environments. Full documentation: README_en.md.

面向 Coding Agent（Claude Code、OpenCode 等）的 GaussDB 只读 MCP 服务器。基于 GaussDB 官方 Go 驱动 （华为云官方开源的 pgx v5 适配版，源码随仓库内置于 third_party/gaussdb-go，支持离线构建）， 通过 stdio 传输提供数据库只读探查工具。

专为内网非 SSL 环境设计：默认 sslmode=disable，配置文件支持同时管理多个 GaussDB 实例。

只读保障（三层纵深防御）

层级机制说明
1. SQL 静态校验internal/guard仅放行单条 SELECT/WITH 查询：拒绝 DML/DDL（含 CTE 内写语句）、SELECT ... INTO、FOR UPDATE/SHARE 行锁、多语句、危险函数（dblink*、set_config、setval、pg_read_file*、pg_terminate_backend、pg_advisory_*、大对象写等，可配置）。词法分析正确跳过字符串/注释/引号标识符，避免误报
2. 事务级强制internal/db所有查询统一在显式只读事务中执行：BEGIN → SET LOCAL TRANSACTION READ ONLY → 查询 → COMMIT（失败回滚）。GaussDB 分布式版仅支持事务级只读设置，该方式在集中式/主备与分布式实例上通用；另设 SET statement_timeout。即使第 1 层被绕过，服务端也会拒绝事务内一切写入（包括函数内部的写）
3. 部署建议README建议使用仅授予 SELECT 权限的数据库账号（见下文），实现权限最小化

提供的 MCP 工具

工具功能
test_connection连通性测试：服务器版本、当前库/用户、只读状态、延迟；可选 instance 参数
list_schemasschema（模式）清单：对象数、注释；include_system 控制是否含系统模式
list_tables表/视图清单：类型（表/视图/物化视图/分区表/外表）、估算行数、注释；可按 schema 过滤
describe_table表结构：列（类型/可空/默认值/注释）、主键与约束、全部索引及定义；视图返回视图定义 SQL；分区表返回分区清单（GaussDB pg_partition）
execute_select执行 SELECT：仅接受单条 SELECT/WITH，受 max_rows/超时限制，返回列名+行数据+是否截断

所有工具均接受可选 instance 参数以选择数据源，缺省使用 default_instance。全部实例名（含默认标注）会写入该参数的 schema 描述，agent 在获取工具列表阶段即可发现可选实例，无需试错。

与同类项目对比

gaussdb-ro-mcp（本项目）GaussDB-MCPMulti DB MCP通用 PostgreSQL MCP 服务器
定位GaussDB 专用只读探查GaussDB 全功能访问：查询、写入、事务、诊断运维、用户权限17 种数据库通用连接器（含 GaussDB/openGauss），MCP + REST API原生 PostgreSQL
GaussDB 适配官方 Go 驱动，集中式/主备/分布式均适配官方 Node.js 驱动（gaussdb-node）走 PostgreSQL 通用协议未适配 GaussDB 专有系统目录（如 pg_partition）
只读保障三层纵深防御：SQL 静态校验 + 事务级 READ ONLY 强制 + 最小权限建议无只读模式（默认 root 管理员账号，按设计支持写入）应用层默认只读各项目实现不一
GaussDB 特有元数据分区表（pg_partition）、外表、物化视图、视图定义 SQL、全部索引定义部分支持按 PG 协议探测，部分支持无
运行时依赖无（静态编译单二进制，可离线部署）Node.js ≥ 20Node.js（npx）各异
多实例管理配置文件集中管理多实例，工具按 instance 参数切换单实例（环境变量）单连接（启动参数）一般单实例
内网非 SSL默认 sslmode=disable支持（默认关闭 SSL）支持支持
许可证Apache-2.0未声明未声明各异

各项目定位不同：需要完整读写与运维能力时，全功能服务器是合理选择；如果目标是让 Coding Agent 安全地探查数据（尤其在生产库上），只读约束与纵深防御是本项目的价值所在。 以上信息基于各项目公开 README 整理（2026-10），如有出入欢迎 提 Issue 指正。

安装

macOS / Linux（Homebrew）：

bash
brew install gxc/tap/gaussdb-ro-mcpgaussdb-ro-mcp --version

从 Releases 下载对应平台的二进制 （linux-amd64 / linux-arm64 / darwin-arm64 / windows-amd64.exe；其他平台或内网环境可自行构建，见下节）。

Linux：

bash
curl -LO https://github.com/gxc/gaussdb-ro-mcp/releases/latest/download/gaussdb-ro-mcp-linux-amd64sudo install -Dm 755 gaussdb-ro-mcp-linux-amd64 /usr/local/bin/gaussdb-ro-mcpgaussdb-ro-mcp --version

macOS（Apple Silicon）：

bash
curl -LO https://github.com/gxc/gaussdb-ro-mcp/releases/latest/download/gaussdb-ro-mcp-darwin-arm64sudo install -Dm 755 gaussdb-ro-mcp-darwin-arm64 /usr/local/bin/gaussdb-ro-mcpgaussdb-ro-mcp --version

Windows（PowerShell；放入 PATH 目录后即可直接调用）：

powershell
Invoke-WebRequest -Uri "https://github.com/gxc/gaussdb-ro-mcp/releases/latest/download/gaussdb-ro-mcp-windows-amd64.exe" -OutFile "gaussdb-ro-mcp.exe"Move-Item .\gaussdb-ro-mcp.exe "$env:LOCALAPPDATA\Microsoft\WindowsApps\"  # 该目录默认在 PATH 中gaussdb-ro-mcp --version

各产物校验值见 Release 页的 SHA256SUMS.txt。

构建

要求 Go 1.26.10+（与 go.mod 一致）。驱动源码已内置于 third_party/gaussdb-go（通过 replace 指令引用）， 正常联网环境下 go build 会自动解析其余依赖；纯内网环境请先在有网环境执行 go mod vendor 后携带 vendor/ 目录，用 go build -mod=vendor 构建。

bash
go build -o gaussdb-ro-mcp ./cmd/gaussdb-ro-mcpsudo install -Dm 755 gaussdb-ro-mcp /usr/local/bin/gaussdb-ro-mcpgaussdb-ro-mcp --version

交叉编译其他平台（纯 Go，CGO_ENABLED=0 即可）：CGO_ENABLED=0 GOOS=<os> GOARCH=<arch> go build -o ... ./cmd/gaussdb-ro-mcp。

配置

复制 gaussdb-ro-mcp.example.yaml 为 gaussdb-ro-mcp.yaml 并修改。 配置文件查找顺序：-config 参数 > 环境变量 GAUSSDB_RO_MCP_CONFIG > ./gaussdb-ro-mcp.yaml。

yaml
server:  max_rows: 500          # execute_select 默认行数上限  max_rows_cap: 10000    # 单次调用可放宽的硬上限  statement_timeout: 30s  connect_timeout: 10s
instances:  - name: prod                    # 实例名称，工具调用时用 instance 参数引用    host: 192.168.0.10    port: 8000    database: postgres    user: readonly_user    password: "****"    sslmode: disable              # 内网非 SSL 默认值  - name: dev    dsn: "gaussdb://readonly_user:****@192.168.1.20:5432/appdb?sslmode=disable"
default_instance: prod

接入 Coding Agent

Claude Code

方式一：项目根目录 .mcp.json（或 claude mcp add 命令）：

json
{  "mcpServers": {    "gaussdb-readonly": {      "command": "/usr/local/bin/gaussdb-ro-mcp",      "args": ["-config", "/path/to/gaussdb-ro-mcp.yaml"]    }  }}
bash
claude mcp add gaussdb-readonly -- /usr/local/bin/gaussdb-ro-mcp -config /path/to/gaussdb-ro-mcp.yaml

OpenCode

opencode.json：

json
{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "gaussdb-readonly": {      "type": "local",      "command": ["/usr/local/bin/gaussdb-ro-mcp", "-config", "/path/to/gaussdb-ro-mcp.yaml"]    }  }}

数据库侧只读账号（强烈建议）

sql
CREATE USER readonly_user WITH PASSWORD 'your-strong-password';GRANT USAGE ON SCHEMA public TO readonly_user;GRANT SELECT ON ALL TABLES IN SCHEMA public TO readonly_user;ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO readonly_user;-- 其他模式按需逐个授权

即使数据库账号被限定为只读，本服务的 SQL 校验与会话强制仍会拦截 锁行（FOR UPDATE）、SELECT INTO、危险函数调用、长查询等行为。

日志

所有运行日志输出到 stderr（stdout 为 MCP 协议通道），包括配置加载、 数据源就绪、会话只读校验结果等，便于在代理客户端的 MCP 日志中排障。

开发与测试

bash
go test ./...                       # 单元测试（SQL 校验、配置解析）GAUSSDB_RO_MCP_TEST_DSN="host=... port=... user=... password=... dbname=... sslmode=disable" \  go test -count=1 ./...            # 集成测试（需 GaussDB/openGauss 实例）

可用 Docker 快速起一个 openGauss 测试实例并灌入测试数据：

bash
docker run -d --name opengauss-ro-test -e GS_PASSWORD='Gaussdb@123' \  -p 127.0.0.1:15433:5432 --privileged docker.m.daocloud.io/enmotech/opengauss:latest
go run ./scripts/devseed "host=127.0.0.1 port=15433 user=gaussdb password=Gaussdb@123 dbname=postgres sslmode=disable"

集成测试覆盖：只读会话强制（服务端拒绝写入）、5 个工具的端到端行为、 真实二进制 stdio 子进程冒烟。注意：本驱动使用 GaussDB 扩展协议（3.51）， 无法连接原生 PostgreSQL，集成测试需要真实的 GaussDB / openGauss 实例。

目录结构

cmd/gaussdb-ro-mcp/     程序入口（stdio MCP 服务器）internal/config/        YAML 配置：多实例数据源、行数/超时等internal/guard/         第 1 层防护：SQL 只读静态校验器internal/db/            多实例连接池 + 第 2 层防护：会话级 READ ONLY 强制、元数据查询internal/tools/         MCP 工具注册与实现scripts/devseed/        集成测试数据灌入工具（开发用）third_party/gaussdb-go/ GaussDB 官方 Go 驱动源码（go.mod replace 引用）

反馈与贡献

欢迎提交 Issue 和 Pull Request：

來源：README.md，提交 7f4c95d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

5
  1. v0.3.0最新Oct 21, 2026
  2. v0.2.5Oct 19, 2026
  3. v0.2.4Sep 29, 2026
  4. v0.2.3Sep 23, 2026
  5. v0.2.2Sep 22, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Only-Mcp 整合

OnlyMCP

com.only-mcp官方發布者

雲端技能、代理與記憶服務，同時可作為其他 MCP 伺服器的閘道，支援遠端端點或 npx 本機執行。

Streamable HTTP可網頁執行驗證方式
知識與記憶需要憑證Oct 29, 2026

OpenVibeCoding Read-only MCP

由 GitHub 帳號 xiaojiou176-open 發布

一個唯讀 MCP 伺服器，讓助理在本機檢視 OpenVibeCoding 的執行、工作流程、證明、佇列、重播與事件記錄。

STDIO僅桌面
效率與工作流尚未驗證Oct 25, 2026

CortexPilot Read-only MCP

由 GitHub 帳號 xiaojiou176-open 發布

唯讀 MCP 伺服器，向助理提供 CortexPilot 的工作流程、佇列狀態、證明、重播與事故摘要。

STDIO僅桌面
效率與工作流尚未驗證Oct 24, 2026

macOS-only MCP server that exposes iMessage chat

由 GitHub 帳號 adelaidasofia 發布

僅限 macOS 的在地 MCP 伺服器，讓助理讀取 chat.db 中的 iMessage 對話紀錄、搜尋訊息，並把對話匯出到 Obsidian 儲存庫。

STDIO僅桌面
檔案與儲存尚未驗證Oct 24, 2026