PostgreSQL performance Tuner MCP Server
provides AI-powered PostgreSQL performance tuning capabilities.
29 stars35 downloads/wk
Reviews
Write oneNobody has reviewed PostgreSQL performance Tuner MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
PostgreSQL performance Tuner MCP Server tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan16 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 122 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install PostgreSQL performance Tuner MCP Server in Claude Code, Cursor or VS Code
claude mcp add pgtuner_mcp -- uvx pgtuner-mcp
What the publisher says
From the PostgreSQL performance Tuner MCP Server repository's README, as published. We do not edit it. Read it on GitHub
PostgreSQL Performance Tuning MCP
A Model Context Protocol (MCP) server that provides AI-powered PostgreSQL performance tuning capabilities. This server helps identify slow queries, recommend optimal indexes, analyze execution plans, and leverage HypoPG for hypothetical index testing.
Features
Query Analysis
- Retrieve slow queries from pgstatstatements with detailed statistics
- Analyze query execution plans with EXPLAIN and EXPLAIN ANALYZE
- Identify performance bottlenecks with automated plan analysis
- Monitor active queries and detect long-running transactions
Index Tuning
- AI-powered index recommendations based on query workload analysis
- Hypothetical index testing with HypoPG extension (no disk usage)
- Find unused and duplicate indexes for cleanup
- Estimate index sizes before creation
- Test query plans with proposed indexes before implementing
Database Health
- Comprehensive health scoring with multiple checks
- Connection utilization monitoring
- Cache hit ratio analysis (buffer and index)
- Lock contention detection
- Vacuum health and transaction ID wraparound monitoring
- Replication lag monitoring
- Background writer and checkpoint analysis
Vacuum Monitoring
- Track long-running VACUUM and VACUUM FULL operations in real-time
- Monitor autovacuum progress and performance
- Identify tables that need vacuuming
- View recent vacuum activity history
- Analyze autovacuum configuration effectiveness
I/O Performance Analysis
- Analyze disk read/write patterns across tables and indexes
- Identify I/O bottlenecks and hot tables
- Monitor buffer cache hit ratios
- Track temporary file usage indicating work_mem issues
- Analyze checkpoint and background writer I/O
- PostgreSQL 16+ enhanced pgstatio metrics support
Configuration Analysis
- Review PostgreSQL settings by category
- Get recommendations for memory, checkpoint, WAL, autovacuum, and connection settings
- Identify suboptimal configurations
MCP Prompts & Resources
- Pre-defined prompt templates for common tuning workflows
- Dynamic resources for table stats, index info, and health checks
- Comprehensive documentation resources
Installation
Standard Installation (for MCP clients like Claude Desktop)
pip install pgtuner_mcpOr using uv:
uv pip install pgtuner_mcpManual Installation
git clone https://github.com/isdaniel/pgtuner_mcp.git
cd pgtuner_mcp
pip install -e .Configuration
Environment Variables
Connection String Format: postgresql://user:password@host:port/database
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
PostgreSQL performance Tuner MCP Server: common questions
- Is PostgreSQL performance Tuner MCP Server safe?
- Mostly: it is graded B (82/100). Read the PostgreSQL performance Tuner MCP Server safety report
- How do I install PostgreSQL performance Tuner MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does PostgreSQL performance Tuner MCP Server need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is PostgreSQL performance Tuner MCP Server maintained?
- The last commit was 133 days ago (2026-06-02). The latest release is v0.5.2.