PostgreSQL 查询连接器（WorkBuddy 市场版）

连接用户的 PostgreSQL 数据库：自动感知表结构、主外键关系和注释，将自然语言转化为 SQL 并直接返回查询结果。默认只读防护，防止误删改数据。

目录结构

postgres-connector-market/
├── connector-meta.json   # 连接器元信息（auth_mode: token）
├── token-schema.json     # 授权表单（地址/端口/库名/账号/密码，密码为 password 类型）
├── mcp.json              # MCP Server 配置（npx 拉起，${VAR} 注入凭证，node 运行时托管）
├── icon.svg              # 市场图标
├── skills/
│   └── postgres-query-usage/
│       └── SKILL.md      # AI 使用说明（自然语言→SQL 工作流 + 安全规则）
└── server/               # MCP Server 源码（Node.js，需发布到 npm）
    ├── package.json      # 包名 workbuddy-postgres-connector
    └── index.js          # 4 个工具：test_connection / get_schema / describe_table / execute_sql

发布步骤

1. 发布 npm 包（mcp.json 通过 npx 拉起）：

   cd server
   npm login          # 需 npm 账号；如无请到 npmjs.com 注册
   npm publish        # 包名若被占用，改 package.json 和 mcp.json 中的名称

2. 本地验证：

   PG_HOST=127.0.0.1 PG_PORT=5432 PG_DATABASE=test PG_USER=postgres PG_PASSWORD=xxx node index.js
   # 另一终端发送 MCP initialize 请求验证握手

3. 提交开放平台：
   • 注册并认证 open.workbuddy.cn（个人认证即可发布连接器）
   • 后台创建「连接器」，上传本目录打包的 zip（connector-meta.json 需在 zip 根层）
   • 测试环境调试 → 提交审核 → 通过后上架市场

授权模式说明（auth_mode: token）

用户在市场点击「连接」时，WorkBuddy 自动弹出 token-schema.json 描述的表单，收集 PG_HOST / PG_PORT / PG_DATABASE / PG_USER / PG_PASSWORD。凭证：

• 仅保存在用户本机 ~/.workbuddy 目录，不经过云端、不打开浏览器；
• 连接时通过环境变量注入 MCP Server，${VAR} 占位符与表单 key 一一对应；
• 密码字段使用 password 类型，满足审核安全红线（对话与日志中不出现明文密码）。

安全设计

• execute_sql 默认只读：仅放行 SELECT / WITH / EXPLAIN / SHOW / VALUES / TABLE， 拦截多语句执行与注释绕过；写操作需显式 allow_write=true；
• SKILL.md 要求 AI 在写操作前必须获得用户确认；
• 单次查询默认最多返回 100 行（可调，上限 1000），statement_timeout 30 秒。

版本要求

• auth_mode: token 需 WorkBuddy ≥ 4.23.0
• mcp.json 的 runtime 字段需 ≥ 5.0.0
• 因此 minWorkbuddyVersion 声明为 5.0.0