用途:对配置好的多个 PostgreSQL 数据库执行只读 SQL 查询,用于查询数据、探索表结构,避免写入或修改数据库。
前置条件:Python 3.8+;安装依赖 pip install -r requirements.txt(psycopg2-binary)。
配置:在技能目录或 ~/.config/claude/postgres-connections.json 创建 connections.json,包含 databases 数组,每项有 name、description、host、database、user、password 等字段,port、sslmode 可选(端口默认 5432)。因含凭据,需设权限:chmod 600 connections.json。
主要能力:列出已配置数据库、执行 SQL 查询、列出表、显示架构、限制返回行数。示例命令:python3 scripts/query.py --list;python3 scripts/query.py --db production --query "SELECT * FROM users LIMIT 10";python3 scripts/query.py --db production --tables;python3 scripts/query.py --db production --schema;python3 scripts/query.py --db production --query "SELECT * FROM orders" --limit 100。也可依据数据库 description 匹配用户意图自动选择数据库,不确定时先用 --list 并询问用户。
安全限制:连接使用 PostgreSQL 只读模式;仅允许 SELECT、SHOW、EXPLAIN、WITH 查询;拒绝多语句;支持配置 SSL 模式;语句超时 30 秒;单次查询最多 10000 行;每列最大宽度 100 字符;错误信息不泄露密码。
适用场景:需要安全读取生产或分析库数据、快速了解表与字段结构、按意图挑选目标数据库的查询任务。
限制与说明:需自行准备可用的数据库连接信息与只读账号;不同数据库的用途需在 description 中准确描述以便匹配。退出码 0 表示成功,1 表示错误(配置缺失、认证失败、无效查询或数据库错误)。官方未提供收费、价格或额外平台支持信息,暂未提供。