PostgreSQL只读查询技能 - 安全连接AI助手执行数据库查询，支持SSL加密与权限控制

postgres by sanjay3290/ai-skills

135 周安装量

169 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/sanjay3290/ai-skills --skill postgres

自动化数据库安全

🇨🇳中文介绍

PostgreSQL 只读查询技能

对配置的 PostgreSQL 数据库执行安全的只读查询。

要求

Python 3.8+
psycopg2-binary: pip install -r requirements.txt

设置

在技能目录或 ~/.config/claude/postgres-connections.json 中创建 connections.json。

安全提示：由于文件包含凭据，请将文件权限设置为 600：

chmod 600 connections.json



{
  "databases": [
    {
      "name": "production",
      "description": "主应用数据库 - 用户、订单、交易",
      "host": "db.example.com",
      "port": 5432,
      "database": "app_prod",
      "user": "readonly_user",
      "password": "your-password",
      "sslmode": "require"
    }
  ]
}

配置字段

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

127,200 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

36,800 周安装

Linux云主机安全托管指南：从SSH加固到HTTPS部署

36,600 周安装

用户询问关于	查找描述包含
用户、账户	users, accounts, customers
订单、销售	orders, transactions, sales
分析、指标	analytics, metrics, reports
日志、事件	logs, events, audit

只读会话：连接使用 PostgreSQL readonly=True 模式（主要保护）
查询验证：仅允许 SELECT、SHOW、EXPLAIN、WITH 查询
单条语句：拒绝每条查询中的多条语句
SSL 支持：可配置的 SSL 模式用于加密连接
查询超时：强制执行 30 秒语句超时
内存保护：每次查询最多 10,000 行以防止内存溢出
列宽限制：每列最多 100 个字符以确保可读输出
凭据清理：错误消息不会泄露密码

错误	解决方案
配置未找到	在技能目录中创建 `connections.json`
身份验证失败	检查配置中的用户名/密码
连接超时	验证主机/端口，检查防火墙/VPN
SSL 错误	对于本地数据库，尝试 `"sslmode": "disable"`
权限警告	运行 `chmod 600 connections.json`

🇺🇸English

PostgreSQL Read-Only Query Skill

Execute safe, read-only queries against configured PostgreSQL databases.

Requirements

Python 3.8+
psycopg2-binary: pip install -r requirements.txt

Setup

Create connections.json in the skill directory or ~/.config/claude/postgres-connections.json.

Security : Set file permissions to 600 since it contains credentials:

chmod 600 connections.json



{
  "databases": [
    {
      "name": "production",
      "description": "Main app database - users, orders, transactions",
      "host": "db.example.com",
      "port": 5432,
      "database": "app_prod",
      "user": "readonly_user",
      "password": "your-password",
      "sslmode": "require"
    }
  ]
}

Config Fields

Field	Required	Description
name	Yes	Identifier for the database (case-insensitive)
description	Yes	What data this database contains (used for auto-selection)
host	Yes	Database hostname
port	No	Port number (default: 5432)
database	Yes	Database name
user	Yes	Username
password	Yes	Password
sslmode	No	SSL mode: disable, allow, prefer (default), require, verify-ca, verify-full

Usage

List configured databases

python3 scripts/query.py --list

Query a database

python3 scripts/query.py --db production --query "SELECT * FROM users LIMIT 10"

List tables

python3 scripts/query.py --db production --tables

Show schema

python3 scripts/query.py --db production --schema

Limit results

python3 scripts/query.py --db production --query "SELECT * FROM orders" --limit 100

Database Selection

Match user intent to database description:

User asks about	Look for description containing
users, accounts	users, accounts, customers
orders, sales	orders, transactions, sales
analytics, metrics	analytics, metrics, reports
logs, events	logs, events, audit

If unclear, run --list and ask user which database.

Safety Features

Read-only session : Connection uses PostgreSQL readonly=True mode (primary protection)
Query validation : Only SELECT, SHOW, EXPLAIN, WITH queries allowed
Single statement : Multiple statements per query rejected
SSL support : Configurable SSL mode for encrypted connections
Query timeout : 30-second statement timeout enforced
Memory protection : Max 10,000 rows per query to prevent OOM
Column width cap : 100 char max per column for readable output
Credential sanitization : Error messages don't leak passwords

Troubleshooting

Error	Solution
Config not found	Create `connections.json` in skill directory
Authentication failed	Check username/password in config
Connection timeout	Verify host/port, check firewall/VPN
SSL error	Try `"sslmode": "disable"` for local databases
Permission warning	Run `chmod 600 connections.json`

Exit Codes

0 : Success
1 : Error (config missing, auth failed, invalid query, database error)

Workflow

Run --list to show available databases
Match user intent to database description
Run --tables or --schema to explore structure
Execute query with appropriate LIMIT

Weekly Installs

135

Repository

sanjay3290/ai-skills

GitHub Stars

169

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex112

opencode110

claude-code107

gemini-cli107

github-copilot102

cursor102

name	是	数据库标识符（不区分大小写）
description	是	此数据库包含的数据内容（用于自动选择）
host	是	数据库主机名
port	否	端口号（默认：5432）
database	是	数据库名称
user	是	用户名
password	是	密码
sslmode	否	SSL 模式：disable, allow, prefer (默认), require, verify-ca, verify-full

PostgreSQL只读查询技能 - 安全连接AI助手执行数据库查询，支持SSL加密与权限控制

🇨🇳中文介绍

PostgreSQL 只读查询技能

要求

设置

配置字段

相关 Skills

使用方法

列出已配置的数据库

查询数据库

列出表

显示模式

限制结果数量

数据库选择

安全特性

故障排除

退出代码

工作流程