用途:maskdb 是只读 REST 网关,把 Postgres 数据库变成掩码化、结构化的查询 API,供 AI 代理安全读取数据,避免暴露敏感列。官方文档见 https://github.com/e7h4n/maskdb。
主要能力:列出令牌可访问的数据库、表、列与索引;查看表结构(含每列的 masked、filterable 标记);执行只读结构化查询,掩码列返回时被打码,例如邮箱显示为 j***@e***.com。查询支持 select、递归 where(and/or/not 及 eq、neq、gt、gte、lt、lte、contains、in、is_null 等操作符)、order_by、limit、offset 分页。响应含 rows、masked、page 字段。
使用方式:需先在 app.vm0.ai/connectors 连接 maskdb 连接器,令牌由 vm0 注入,具备 db:query 与 db:metadata 只读权限。所有请求带 Authorization: Bearer $MASKDB_TOKEN,Base URL 为 https://api.maskdb.ai。常用端点:GET /v1/databases;GET /v1/databases/<database>/tables;GET /v1/databases/<database>/tables/<table>/schema;GET /v1/databases/<database>/tables/<table>/indexes;POST /v1/databases/<database>/query,请求体为结构化 JSON。连接失败可运行 zero doctor check-connector --env-name MASKDB_TOKEN,或 zero doctor check-connector --url https://api.maskdb.ai/v1/databases --method GET。
适用场景:需要安全只读访问 Postgres、读取数据但不暴露敏感字段、以及让 AI 代理做结构化数据探索时使用。
限制:仅只读,无写入、更新、删除端点,也不接受原始 SQL;掩码列可出现在 select 但用于 where 或 order_by 会返回 HTTP 400;建议先查 schema 再构造查询;分页依赖 limit 与 offset。其他收费、部署等细节资料暂未提供。