← Back to Skills Marketplace
victorzhou123

postgres mcp

by victorzhou123 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
395
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install postgres-mcp-skill
Description
PostgreSQL database management and optimization assistant. Provides complete database operation capabilities: health checks, index optimization, query plan a...
Usage Guidance
This skill is coherent: it delegates work to a postgres-mcp service and requires you to install/configure that service and provide a PostgreSQL connection string. Before installing or running: (1) verify the upstream postgres-mcp project/image (ghcr.io/crystaldba/postgres-mcp and the pip package) so you trust the code you will run; (2) be careful where you store DATABASE_URL/connection strings — placing credentials in config files or command lines can expose them via disk or process listings; (3) prefer read-only mode when you only need observation/analysis and require explicit confirmation before any write/DDL operations; (4) if you do run the Docker image or pip package, follow your org policies for third-party images/packages and run them in an isolated environment if possible; (5) scheduling periodic health checks or caching schema implies persistent changes you must set up yourself — the skill will not silently exfiltrate credentials or run arbitrary downloads as part of the skill bundle.
Capability Analysis
Type: OpenClaw Skill Name: postgres-mcp-skill Version: 1.0.0 The postgres-mcp-skill bundle is a well-structured set of instructions for an AI agent to manage PostgreSQL databases via a Model Context Protocol (MCP) server. It includes comprehensive modules for health checks, index tuning, query plan analysis, and schema management (e.g., in SKILL.md and reference/pg-execute.md). The bundle prioritizes safety by instructing the agent to confirm write/DDL operations with the user, utilize read-only modes, and employ parameterized queries to prevent SQL injection. No evidence of data exfiltration, malicious execution, or unauthorized persistence was found; the setup instructions (reference/setup-postgres-mcp.md) use standard deployment methods like Docker and Python.
Capability Assessment
Purpose & Capability
The skill's name/description (PostgreSQL management, health, index tuning, query plans, schema queries, execution) matches the SKILL.md and the included reference docs. All runtime actions are described as calls to postgres-mcp MCP tools (get_database_health, suggest_indexes, analyze_query_plan, etc.), which is coherent with the stated purpose.
Instruction Scope
Instructions consistently route work to external MCP tools and require a pre-check that the postgres-mcp tools are available. The SKILL.md and references suggest editing client configuration files to register an MCP server, using pipx or Docker to run the postgres-mcp service, caching schema results, and optionally scheduling periodic health checks. These behaviors are expected for this kind of skill but imply the agent/operator must modify client config files and may persist cached schema data or set up scheduled tasks — the skill itself is instruction-only and does not contain code that performs these operations automatically.
Install Mechanism
The bundle is instruction-only and contains no install spec. Setup docs instruct using pipx or running a Docker image (ghcr.io/crystaldba/postgres-mcp:latest). These are standard install methods; they do pull code from external sources (PyPI for pipx and GitHub Container Registry for the image). That is expected here, but users should verify the upstream package/image source and trustworthiness before installing.
Credentials
The skill declares no required environment variables in the registry metadata. The documentation references service configuration variables (DATABASE_URL, POSTGRES_MCP_READ_ONLY, POSTGRES_MCP_QUERY_TIMEOUT) and expects the operator to provide a database connection string (which contains DB credentials). This is proportionate to the skill's function, but be aware these connection strings contain secrets and may be stored in client config files or appear on command lines (process lists) if set that way.
Persistence & Privilege
The skill does not request always:true and does not install persistent components itself. It instructs users to configure their client (editing claude_desktop_config.json, .cursor/mcp.json, or using Docker/SSE URLs) to register an external MCP server—that requires modifying client config files but is normal for MCP integrations. The skill does not request elevated system-wide privileges or attempt to change other skills' configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install postgres-mcp-skill
  3. After installation, invoke the skill by name or use /postgres-mcp-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
postgres-mcp-skill v1.0.0 changelog - Initial release of the PostgreSQL database management and optimization assistant. - Supports health checks, index optimization, query plan analysis, schema queries, and SQL execution via postgres-mcp tools. - Includes mandatory pre-check to ensure postgres-mcp MCP tools are available before any operation. - Implements intent recognition and routing for common PostgreSQL tasks. - Enforces safety constraints: confirmation required for write operations, read-only mode support, and performance protection for long-running queries.
Metadata
Slug postgres-mcp-skill
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is postgres mcp?

PostgreSQL database management and optimization assistant. Provides complete database operation capabilities: health checks, index optimization, query plan a... It is an AI Agent Skill for Claude Code / OpenClaw, with 395 downloads so far.

How do I install postgres mcp?

Run "/install postgres-mcp-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is postgres mcp free?

Yes, postgres mcp is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does postgres mcp support?

postgres mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created postgres mcp?

It is built and maintained by victorzhou123 (@victorzhou123); the current version is v1.0.0.

💬 Comments