mcp-postgres

MCP-Server für PostgreSQL. Bietet KI-Agenten Schema-Intelligenz, Abfrageausführung und DBA-Tools – über das Model Context Protocol.

Im Gegensatz zu generischen Datenbank-MCP-Servern ist mcp-postgres nativ für Postgres entwickelt. Es extrahiert Tabellen-/Spaltenkommentare, versteht Postgres-spezifische Katalogansichten, bietet Indexanalysen und wird mit konfigurierbaren Zugriffsebenen geliefert, damit Sie einer KI keinen uneingeschränkten Datenbankzugriff gewähren müssen.

Funktionen

Schema-Intelligenz

• Auflisten von Schemas, Tabellen und Ansichten mit Größen und Zeilenanzahlen

• Vollständige Tabellenbeschreibungen: Spalten, Typen, Constraints, Indizes, Fremdschlüssel

• Extrahiert COMMENT ON-Metadaten – gibt der KI semantischen Kontext darüber, was Spalten bedeuten

• Suche nach Objekten anhand von Namen oder Kommentaren in der gesamten Datenbank

Abfrageausführung

• Schreibgeschütztes query-Tool mit automatischer Zeilenbegrenzung

• Schreibfähiges execute-Tool, das durch Zugriffsebenen gesteuert wird

• EXPLAIN ANALYZE mit menschenlesbarer Ausgabe

DBA-Tools

• Tabellenstatistiken: Live/Dead-Tupel, Bloat-Prozentsatz, Vacuum-Historie, Scan-Muster

• Indexanalyse: Nutzungsstatistiken, Erkennung ungenutzter Indizes, Vorschläge für fehlende Indizes

• Datenbankgesundheit: Verbindungen, Cache-Trefferquote, lang laufende Abfragen, Durchsatz

Sicherheit

• Vier Zugriffsebenen: readonly, readwrite, admin, unrestricted

• Klassifizierung von SQL-Anweisungen (SELECT, DML, DDL, admin) mit Durchsetzung

• Audit-Logging nach stderr (JSON, ein Eintrag pro Abfrage)

Schnellstart

npx mcp-postgres --connection-string "postgres://user:pass@localhost:5432/mydb"

Oder mit Umgebungsvariablen:

DATABASE_URL="postgres://user:pass@localhost:5432/mydb" npx mcp-postgres

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-postgres",
        "--connection-string",
        "postgres://user:pass@localhost:5432/mydb"
      ]
    }
  }
}

Claude Code

Fügen Sie dies zu der .mcp.json Ihres Projekts hinzu:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "mcp-postgres"],
      "env": {
        "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb"
      }
    }
  }
}

Tools

*explain_query mit analyze=true führt die Abfrage aus und respektiert daher die Zugriffsebene der Anweisung.

Ressourcen

Prompts

Konfiguration

CLI-Optionen

--connection-string  PostgreSQL connection URL
--access-level       readonly|readwrite|admin|unrestricted (default: readonly)
--row-limit          Max rows returned per query (default: 500)
--schema             Default schema filter (default: public)
--audit              Enable query audit logging to stderr

Umgebungsvariablen

Zugriffsebenen

Standard ist readonly. Verwenden Sie die minimal erforderliche Ebene.

Audit-Logging

Aktivieren mit --audit. Protokolliert jeden Tool-Aufruf in stderr als JSON:

{"timestamp":"2026-04-03T12:00:00.000Z","tool":"query","sql":"SELECT * FROM users","statementType":"select","accessLevel":"readonly","allowed":true,"durationMs":12,"rowCount":42}

Leiten Sie stderr in eine Datei um, um sie zu erfassen: mcp-postgres --audit 2>audit.log

Architektur

src/
├── index.ts             Entry point and CLI
├── server.ts            MCP server setup
├── config.ts            Configuration parsing
├── db/
│   ├── pool.ts          Connection pool management
│   └── query.ts         Query execution with timing
├── tools/
│   ├── schema.ts        Schema exploration tools
│   ├── query.ts         Query execution tools
│   └── performance.ts   DBA and health tools
├── resources/
│   └── schema.ts        Schema DDL resources
├── prompts/
│   └── index.ts         Prompt templates
└── safety/
    ├── classifier.ts    SQL statement classification
    ├── access.ts        Access level enforcement
    └── audit.ts         Audit logging

Entwicklung

npm install
npm test           # run tests
npm run build      # compile TypeScript
npm run dev -- --connection-string "postgres://..."  # run in dev mode

Lizenz

MIT