pg-context
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 = ONfür jede Clientverbindung und lehnt ändernde SQL-Anweisungen ab (wieDROP,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-mcpOder installieren Sie es global:
npm install -g pg-context-mcp
pg-context-mcpKonfiguration
pg-context liest Verbindungsparameter aus Umgebungsvariablen oder Standard-Verbindungsstrings für PostgreSQL:
Variable | Beschreibung | Standard |
| Standard-PostgreSQL-Verbindungs-URI |
|
| Datenbankhost |
|
| Datenbank-Port |
|
| Datenbankname |
|
| Datenbankbenutzer |
|
| Datenbankpasswort |
|
| SSL-Verbindung aktivieren ( |
|
| Kommagetrennte Liste der Ziel-Schemata |
|
| Größe des Verbindungspools |
|
| TTL des Schema-Caches in Sekunden |
|
| Standardzeilengrenze für |
|
| Harte Obergrenze für |
|
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 |
| keine | Listet alle Nicht-System-Schemata in der Datenbank auf. |
|
| Listet Tabellen und Sichten mit Größen, geschätzten Zeilenanzahlen und Kommentaren auf. |
|
| Gibt das vollständige strukturelle DDL einer Tabelle zurück, einschließlich Spalten, Typen, Standardwerten, NOT NULL, Fremdschlüsseln und Indizes. |
|
| Zeigt Fremdschlüsselbeziehungen als lesbare |
|
| Zeigt Indizes, Definitionen, Größen und Scan-Anzahlen an. |
|
| Erkennt nicht indizierte Fremdschlüssel, Sequential-Scan-Warnungen und ungenutzte Indizes. |
|
| Führt Nur-Lese-Abfragen mit erzwungenen Grenzwerten aus und gibt Markdown-Tabellen zurück. |
|
| Gibt Abfrageausführungspläne von PostgreSQL |
| keine | Gibt die PostgreSQL-Version, die Gesamtgröße der Datenbank, Verbindungsanzahlen und Puffereinstellungen zurück. |
|
| Gibt Sequential- vs. Index-Scans, lebende Zeilen, tote Zeilen und Wartungsdaten zurück. |
|
| Ruft die langsamsten Abfragen ab, die von |
| 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 |
|
| Vollständiger DDL-Dump aller Tabellen über die konfigurierten Schemata. |
|
| DDL-Definition für eine einzelne Tabelle. |
|
| Ü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 startLizenz
MIT (c) Semen
This server cannot be installed
Maintenance
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
Analytical memory for AI agents: a real Postgres queried in plain English over MCP. One command.
MCP server for managing Prisma Postgres.
MCP server for interacting with the Supabase platform
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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