Skip to main content
Glama

pg-context

Model Context Protocol (MCP)-Server, der KI-Codierungsassistenten tiefen PostgreSQL-Kontext bietet: Live-Schemata als DDL, Index-Gesundheit, Fremdschlüssel-Zuordnungen, Abfrageausführungspläne und Leistungsstatistiken.

pg-context verbindet sich direkt mit Ihrer PostgreSQL-Datenbank im Nur-Lese-Modus und stellt Tools und Ressourcen für KI-Assistenten wie Cursor, Claude Code, Cline und Antigravity bereit.


Warum pg-context?

Generische SQL-Tools führen oft beliebige Abfragen aus, ohne dem KI-Assistenten strukturellen Kontext zu geben. Dadurch raten Modelle Spaltennamen, erfinden Beziehungen und erzeugen ungültige Joins.

pg-context löst dieses Problem, indem es Folgendes bereitstellt:

  • Schemakontext ohne Raten: Exportiert reale Tabellenstrukturen als PostgreSQL-CREATE TABLE-DDL-Anweisungen mit Fremdschlüssel-Kommentaren und Indexdefinitionen.

  • Nur-Lese-Sicherheit: Setzt automatisch default_transaction_read_only = ON für jede Clientverbindung und lehnt ändernde SQL-Anweisungen ab (wie DROP, DELETE, UPDATE, INSERT, TRUNCATE, ALTER).

  • Optimierungseinblicke: Erkennt nicht indizierte Fremdschlüssel, hohe Sequential-Scan-Anteile, ungenutzte Indizes und langsame Abfragen aus pg_stat_statements.

  • Erweiterungsbewusstsein: Identifiziert PostGIS-, TimescaleDB- und pgvector-Erweiterungen.


Schnellstart

Sie können pg-context direkt über npx ausführen, ohne manuelle Installation:

npx -y pg-context-mcp

Oder installieren Sie es global:

npm install -g pg-context-mcp
pg-context-mcp

Konfiguration

pg-context liest Verbindungsparameter aus Umgebungsvariablen oder Standard-Verbindungsstrings für PostgreSQL:

Variable

Beschreibung

Standard

DATABASE_URL

Standard-PostgreSQL-Verbindungs-URI

undefined

PGHOST

Datenbankhost

localhost

PGPORT

Datenbank-Port

5432

PGDATABASE

Datenbankname

postgres

PGUSER

Datenbankbenutzer

postgres

PGPASSWORD

Datenbankpasswort

""

PGSSL

SSL-Verbindung aktivieren (true/false)

false

PG_SCHEMAS

Kommagetrennte Liste der Ziel-Schemata

public

PG_MAX_CONNECTIONS

Größe des Verbindungspools

5

PG_CACHE_TTL

TTL des Schema-Caches in Sekunden

60

PG_QUERY_LIMIT

Standardzeilengrenze für read_query

100

PG_QUERY_LIMIT_MAX

Harte Obergrenze für read_query

1000


Client-Integration

1. Claude Desktop & Antigravity

Fügen Sie den folgenden Eintrag zu Ihrer claude_desktop_config.json oder den Antigravity-MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "pg-context": {
      "command": "npx",
      "args": ["-y", "pg-context-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/my_database"
      }
    }
  }
}

2. Cursor

Fügen Sie Folgendes zu Ihrer Cursor-MCP-Konfiguration hinzu (.cursor/mcp.json oder Cursor Settings > Features > MCP):

{
  "mcpServers": {
    "pg-context": {
      "command": "npx",
      "args": ["-y", "pg-context-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/my_database"
      }
    }
  }
}

3. Cline (VS Code Extension)

Fügen Sie diese Konfiguration in cline_mcp_settings.json ein:

{
  "mcpServers": {
    "pg-context": {
      "command": "npx",
      "args": ["-y", "pg-context-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/my_database"
      }
    }
  }
}

Tool-Referenz

pg-context stellt 12 MCP-Tools bereit:

Tool

Parameter

Beschreibung

list_schemas

keine

Listet alle Nicht-System-Schemata in der Datenbank auf.

list_tables

schema (Standard: "public")

Listet Tabellen und Sichten mit Größen, geschätzten Zeilenanzahlen und Kommentaren auf.

describe_table

table, schema (Standard: "public")

Gibt das vollständige strukturelle DDL einer Tabelle zurück, einschließlich Spalten, Typen, Standardwerten, NOT NULL, Fremdschlüsseln und Indizes.

list_foreign_keys

schema (Standard: "public"), table (optional)

Zeigt Fremdschlüsselbeziehungen als lesbare source -> target-Zuordnungen an.

list_indexes

schema (Standard: "public"), table (optional)

Zeigt Indizes, Definitionen, Größen und Scan-Anzahlen an.

suggest_indexes

schema (Standard: "public"), table (optional)

Erkennt nicht indizierte Fremdschlüssel, Sequential-Scan-Warnungen und ungenutzte Indizes.

read_query

sql, limit (optional)

Führt Nur-Lese-Abfragen mit erzwungenen Grenzwerten aus und gibt Markdown-Tabellen zurück.

explain_query

sql, analyze (boolesch, Standard: false)

Gibt Abfrageausführungspläne von PostgreSQL EXPLAIN oder EXPLAIN ANALYZE zurück.

get_database_info

keine

Gibt die PostgreSQL-Version, die Gesamtgröße der Datenbank, Verbindungsanzahlen und Puffereinstellungen zurück.

get_table_stats

schema (Standard: "public"), table (optional)

Gibt Sequential- vs. Index-Scans, lebende Zeilen, tote Zeilen und Wartungsdaten zurück.

get_slow_queries

limit (Standard: 15)

Ruft die langsamsten Abfragen ab, die von pg_stat_statements aufgezeichnet wurden.

list_extensions

keine

Listet installierte PostgreSQL-Erweiterungen auf und kennzeichnet Fähigkeiten für PostGIS, TimescaleDB und pgvector.


Ressourcen-Referenz

pg-context stellt 3 MCP-Ressourcen bereit:

Ressourcen-URI

MIME-Typ

Beschreibung

pg://schema/full

text/x-sql

Vollständiger DDL-Dump aller Tabellen über die konfigurierten Schemata.

pg://schema/{tableName}

text/x-sql

DDL-Definition für eine einzelne Tabelle.

pg://stats/overview

text/markdown

Übersicht über die Datenbankgesundheit: Speichergrößen, tote Zeilen und Optimierungswarnungen.


Entwicklung

# Clone the repository
git clone https://github.com/mewsyy/pg-context.git
cd pg-context

# Install dependencies
npm install

# Run test suite
npm test

# Build TypeScript
npm run build

# Start local server
npm start

Lizenz

MIT (c) Semen

-
license - not tested
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mewsyy/pg-context'

If you have feedback or need assistance with the MCP directory API, please join our Discord server