feat: implement PostgresAdapter with pg_partman and pg_stat_kcache tools, updating documentation and tool filtering.

Author: Temp

CHANGELOG.md

@@ -35,13 +35,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `pg_cron_job_run_details` — View execution history
   - `pg_cron_cleanup_history` — Clean old history records
 - New `cron` tool-filtering group for pg_cron tools
+- **10 pg_partman tools** — Automated partition lifecycle management
+  - `pg_partman_create_extension` — Enable pg_partman
+  - `pg_partman_create_parent` — Create partition set with automatic child creation
+  - `pg_partman_run_maintenance` — Execute partition maintenance
+  - `pg_partman_show_partitions` — List managed partitions
+  - `pg_partman_show_config` — View partition configuration
+  - `pg_partman_check_default` — Check for data in default partition
+  - `pg_partman_partition_data` — Move data to child partitions
+  - `pg_partman_set_retention` — Configure retention policies
+  - `pg_partman_undo_partition` — Convert back to regular table
+  - `pg_partman_analyze_partition_health` — Health check with recommendations
+- New `partman` tool-filtering group for pg_partman tools
+- **7 pg_stat_kcache tools** — OS-level performance visibility
+  - `pg_kcache_create_extension` — Enable pg_stat_kcache
+  - `pg_kcache_query_stats` — Query stats with CPU/IO metrics
+  - `pg_kcache_top_cpu` — Top CPU-consuming queries
+  - `pg_kcache_top_io` — Top I/O-consuming queries
+  - `pg_kcache_database_stats` — Database-level aggregated stats
+  - `pg_kcache_resource_analysis` — CPU-bound vs I/O-bound classification
+  - `pg_kcache_reset` — Reset statistics
+- New `kcache` tool-filtering group for pg_stat_kcache tools
 
 ### Changed
 - Restructured resources into modular files for maintainability
 - Resource count from 6 to 14
 - Prompt count from 7 to 13
 - Restructured prompts into modular files for maintainability
-- Tool count from 146 to 154 (added pg_cron tools)
+- Tool count from 146 to 171 (added pg_cron, pg_partman, and pg_stat_kcache tools)
 
 ### Planned
 - Verify prompts and resources from old Python server are ported

README.md

@@ -4,17 +4,17 @@
 
 *Last updated December 14, 2025 - Initial Implementation Complete*
 
-*Enterprise-grade PostgreSQL MCP Server with OAuth 2.0 authentication, connection pooling, tool filtering, plus support for pg_cron, pgvector, PostGIS, and advanced PostgreSQL features - TypeScript Edition*
+*Enterprise-grade PostgreSQL MCP Server with OAuth 2.0 authentication, connection pooling, tool filtering, plus support for pg_cron, pg_stat_kcache, pgvector, PostGIS, and advanced PostgreSQL features - TypeScript Edition*
 
-> **✅ Initial Implementation Complete** - 154 tools, 14 resources, and 13 prompts. Thorough testing before release in progress.
+> **✅ Initial Implementation Complete** - 171 tools, 14 resources, and 13 prompts. Thorough testing before release in progress.
 
 [![GitHub](https://img.shields.io/badge/GitHub-neverinfamous/postgres--mcp-blue?logo=github)](https://github.com/neverinfamous/postgres-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
 [![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)
 ![Status](https://img.shields.io/badge/status-Testing-blue)
 
-A **PostgreSQL MCP Server** that enables AI assistants (Claude, Cursor, etc.) to interact with PostgreSQL databases through the Model Context Protocol. Provides **154 specialized tools**, **14 resources**, and **13 AI-powered prompts**.
+A **PostgreSQL MCP Server** that enables AI assistants (Claude, Cursor, etc.) to interact with PostgreSQL databases through the Model Context Protocol. Provides **171 specialized tools**, **14 resources**, and **13 AI-powered prompts**.
 
 ---
 
@@ -102,7 +102,7 @@ node dist/cli.js --transport stdio --postgres postgres://user:password@localhost
 
 ## 🛠️ Tool Categories
 
-This server provides **154 tools** across 14 categories:
+This server provides **171 tools** across 16 categories:
 
 | Category | Tools | Description |
 |----------|-------|-------------|
@@ -120,13 +120,15 @@ This server provides **154 tools** across 14 categories:
 | PostGIS | 12 | Geospatial operations - distance, transform, clustering, index optimization |
 | Partitioning | 6 | Range/list/hash partitioning management |
 | Cron | 8 | pg_cron extension - job scheduling, monitoring, cleanup |
+| Partman | 10 | pg_partman extension - automated partition lifecycle management |
+| Kcache | 7 | pg_stat_kcache extension - OS-level CPU/memory/I/O stats per query |
 
 ---
 
 ## 🎛️ Tool Filtering
 
 > [!IMPORTANT]
-> **AI-enabled IDEs like Cursor have tool limits.** With 154 tools, you should use tool filtering to stay within limits.
+> **AI-enabled IDEs like Cursor have tool limits.** With 171 tools, you should use tool filtering to stay within limits.
 
 ### Tool Groups
 
@@ -146,6 +148,8 @@ This server provides **154 tools** across 14 categories:
 | `postgis` | 12 | PostGIS extension |
 | `partitioning` | 6 | Partition management |
 | `cron` | 8 | pg_cron job scheduling |
+| `partman` | 10 | pg_partman partition lifecycle |
+| `kcache` | 7 | pg_stat_kcache OS-level stats |
 
 ### Filter Presets
 
@@ -161,7 +165,7 @@ This server provides **154 tools** across 14 categories:
 
 **DBA (~75 tools):**
 ```json
-"--tool-filter", "-vector,-postgis,-cron"
+"--tool-filter", "-vector,-postgis,-cron,-partman,-kcache"
 ```
 
 ### Custom Filtering Syntax
@@ -229,6 +233,8 @@ This server provides **14 resources** for structured data access:
 | `pgvector` | Vector similarity search | 14 vector tools |
 | `PostGIS` | Geospatial operations | 12 postgis tools |
 | `pg_cron` | Job scheduling | 8 cron tools |
+| `pg_partman` | Automated partition management | 10 partman tools |
+| `pg_stat_kcache` | OS-level CPU/memory/I/O stats | 7 kcache tools |
 
 > Extension tools gracefully handle cases where extensions are not installed.
 

src/adapters/postgresql/PostgresAdapter.ts

@@ -40,6 +40,8 @@ import { getPostgisTools } from './tools/postgis.js';
 import { getPartitioningTools } from './tools/partitioning.js';
 import { getStatsTools } from './tools/stats.js';
 import { getCronTools } from './tools/cron.js';
+import { getPartmanTools } from './tools/partman.js';
+import { getKcacheTools } from './tools/kcache.js';
 import { getPostgresResources } from './resources/index.js';
 import { getPostgresPrompts } from './prompts/index.js';
 
@@ -537,7 +539,9 @@ export class PostgresAdapter extends DatabaseAdapter {
             'postgis',
             'partitioning',
             'stats',
-            'cron'
+            'cron',
+            'partman',
+            'kcache'
         ];
     }
 
@@ -560,7 +564,9 @@ export class PostgresAdapter extends DatabaseAdapter {
             ...getPostgisTools(this),
             ...getPartitioningTools(this),
             ...getStatsTools(this),
-            ...getCronTools(this)
+            ...getCronTools(this),
+            ...getPartmanTools(this),
+            ...getKcacheTools(this)
         ];
     }