Neon MCP Server

Offizieller Remote-MCP-Server für Neon Postgres, Projekte, Branches, SQL, Schema und Migrationen.

Beschreibung

Neon MCP Server ist der offizielle Model-Context-Protocol-Server von Neon für die Arbeit mit Neon Postgres. Er verbindet natürliche Sprache in einem MCP-Client mit der Neon API und mit ausgewählten Datenbankfunktionen. Der direkte Produktlink führt zur Neon-Dokumentation, das Repository neondatabase/mcp-server-neon enthält Quellcode, Installationsvarianten und Lizenz. Laut Anbieter kann der Server Projekte und Branches verwalten, SQL ausführen, Datenbankschemas beschreiben, Migrationen vorbereiten und Neon-Dokumentation bereitstellen. Damit liegt der Schwerpunkt nicht auf generischer Datenanalyse, sondern auf datenbanknaher Entwicklungs- und Betriebsarbeit.

Remote-Server für Postgres-Workflows

Neon beschreibt mehrere Wege zur Einrichtung. Der schnelle API-Key-Einstieg läuft mit npx neon@latest init und richtet den MCP Server laut README für Cursor, VS Code/GitHub Copilot und Claude Code ein. Alternativ kann der gehostete Remote-Server über https://mcp.neon.tech/mcp per OAuth oder API-Key angebunden werden. Für ältere Clients ist SSE weiterhin möglich, aber Streamable HTTP ist der modernere Pfad. Der gehostete Server läuft laut Repository als Next.js-App auf Vercel; der lokale Entwicklungsweg nutzt Node.js, Corepack und pnpm.

Projekte, Branches, Abfragen und Migrationen

Der praktische Nutzen liegt in typischen Postgres-Aufgaben, die Entwickler sonst zwischen Console, SQL-Client und Codebasis verteilen. Ein Agent kann ein Neon-Projekt zusammenfassen, Tabellenstrukturen erklären, lesende SQL-Abfragen ausführen, Branches für Änderungen nutzen oder eine Migration vorbereiten. Besonders stark ist der Ansatz bei Feature-Arbeit mit Branching: Ein Datenbankschema kann in einer isolierten Neon-Branch geprüft werden, bevor Änderungen in Richtung Hauptzweig wandern. Für Redaktion, Analyse und Support kann der Server außerdem helfen, vorhandene Datenstrukturen zu verstehen, ohne sofort manuell durch die Oberfläche zu klicken.

Sicherheit, Read-only-Modus und Datenfluss

Neon warnt ausdrücklich, dass der MCP Server mächtige Datenbankverwaltungsfunktionen über natürliche Sprache bereitstellt. Nutzer sollen vom LLM angeforderte Aktionen prüfen und autorisieren; für Produktionsumgebungen empfiehlt Neon den Einsatz nicht. Wichtig sind Projektbegrenzung, Organisationskontext, OAuth-Scopes und Read-only-Modus. readonly=true kann Schreibwerkzeuge wie Projekt- oder Branch-Erstellung und Migrationen deaktivieren; lesende Werkzeuge wie Schema- und Performance-Abfragen bleiben je nach Konfiguration verfügbar. Bei IP-Allowlists nennt die README statische IPs für mcp.neon.tech, die bewusst freigegeben werden müssen.

Lizenz, GitHub-Sterne und Einordnung

Das Repository steht unter MIT-Lizenz. Die GitHub-API meldete am 07.09.2026 exakt 629 Sterne; diese Momentaufnahme zeigt Popularität, aber keine Sicherheits- oder Qualitätsgarantie. Der Server selbst ist quelloffen, die Nutzung setzt jedoch ein Neon-Konto und passende Berechtigungen voraus. Öffentliche Katalogtexte sollten keine festen Preise nennen; aktuelle Plan- und Nutzungsbedingungen stehen bei Neon. Dieser Eintrag passt zu DevOps und Datenanalyse, weil er Datenbankbetrieb, Schema-Verständnis, Abfragen und migrationsnahe Automatisierung verbindet. Ein sicherer Start ist ein Testprojekt mit Read-only-URL oder eng begrenztem API-Key.

Für Produktteams ist die Grenze zwischen hilfreicher Assistenz und riskanter Automatisierung schmal. Der Server sollte deshalb zunächst erklären und lesen, nicht ungeprüft produktive Strukturen ändern. Jede Migration, Branch-Aktion oder schreibende SQL-Ausführung braucht eine nachvollziehbare menschliche Freigabe. Sinnvoll ist außerdem eine klare Trennung zwischen Entwicklungs-, Staging- und Produktionsprojekten, damit ein Agent nicht versehentlich auf die falsche Datenbank zielt.

Voraussetzungen

MCP-Client, Neon-Konto und je nach Setup Node.js ab 18, OAuth oder Neon-API-Key.

Installationsanleitung

Neon MCP kann Postgres-Projekte, Branches und Datenbanken verwalten. Für den Einstieg verbinden wir den gehosteten Server im Read-only-Modus. Neon empfiehlt den MCP-Server für lokale Entwicklung und IDE-Integrationen, nicht für produktive Datenbankumgebungen. Verwende einen Entwicklungs-Branch und keine echten Kundendaten.

Schritt 1: Einen Entwicklungszugang vorbereiten

Du brauchst ein Neon-Konto und einen HTTP-MCP-Client mit OAuth-Unterstützung. Lege den gewünschten Test-Branch im Neon-Dashboard fest und notiere Projekt- und Branch-ID. Die Remote-Verbindung benötigt keinen lokal laufenden Serverprozess. Prüfe Claude Code im Terminal:

bash
claude --version

Schritt 2: Neon mit Leserechten verbinden

Registriere den Endpunkt mit ausdrücklich aktivierter Lesebeschränkung:

bash
claude mcp add --transport http neon "https://mcp.neon.tech/mcp?readonly=true"

Erwartet wird eine registrierte Verbindung namens neon. readonly=true begrenzt die angebotenen Werkzeuge; ein reiner Textauftrag „nicht schreiben“ ersetzt diese Einstellung nicht.

Schritt 3: OAuth-Zugriff kontrollieren

Öffne in einer interaktiven Claude-Code-Sitzung:

text
/mcp

Wähle neon, melde dich im Browser an und prüfe den bestätigten Zugriff. Für Organisationsprojekte müssen die passenden Projekt- oder Organisations-IDs ausdrücklich angegeben werden. Eine mit readonly=true festgelegte Freigabe lässt sich nicht einfach im Dialog zu Schreibrechten erweitern. Für eine andere Berechtigung ist eine neue, bewusste Autorisierung nötig.

Schritt 4: Den Test-Branch lesend prüfen

Ersetze die beiden Platzhalter durch die IDs deines Entwicklungsprojekts und stelle diese Anfrage im Client:

text
Nutze neon für Projekt PROJECT_ID und Branch BRANCH_ID. Beschreibe nur das vorhandene Tabellenschema. Erstelle keine Projekte, Branches, Tabellen oder Migrationen und gib keine Zugangsdaten aus.

Vergleiche das Ergebnis mit der Neon-Konsole. Prüfe später jede SQL-Anfrage, insbesondere Filter und Datenumfang. Read-only verhindert keine Offenlegung vertraulicher Daten im Modellkontext.

Schritt 5: Alternative automatische Einrichtung verstehen

Wenn Node.js und npm vorhanden sind, bietet Neon alternativ einen Einrichtungsassistenten:

bash
npx neon@latest init

Dieser Weg kann Editoren erkennen, OAuth durchführen, einen API-Schlüssel erzeugen und weitere Agent-Werkzeuge einrichten. Er ist eine Alternative zur oben beschriebenen Verbindung, kein notwendiger Zusatzschritt. Prüfe die geplanten Konfigurationsänderungen und bereinige doppelte Verbindungen bewusst. Für die lokale stdio-Variante werden Node.js und ein Neon-API-Schlüssel benötigt; Details stehen im Repository.

Alternative: Cursor mit Read-only konfigurieren

Füge diesen Eintrag in die vorhandene MCP-Konfiguration ein und schließe danach den OAuth-Login ab:

json
{
  "mcpServers": {
    "neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp?readonly=true"
    }
  }
}

Bei Verbindungsproblemen prüfe Konto, Projekt-ID und gegebenenfalls die Neon-IP-Allowlist. Für Migrationen und Branch-Erstellung wären Schreibrechte erforderlich; verwende dafür einen getrennten, geprüften Entwicklungsablauf. Offizielle Quelle: https://github.com/neondatabase/mcp-server-neon. Kein authentifizierter Praxistest durchgeführt.

npx neon@latest init

Authentifizierung

OAuth oder Neon-API-Key; Read-only und Tool-Kategorien können über Scopes beziehungsweise URL-Parameter begrenzt werden.

Benötigte Zugriffsrechte

Rechte folgen OAuth-Scopes, API-Key, Projekt-/Organisationskontext und URL-Parametern wie readonly oder category.

Übertragene oder gespeicherte Daten

Werkzeugaufrufe laufen gegen Neon API und Datenbankfunktionen; Antworten werden an den MCP-Client zurückgegeben.

Sicherheitsrisiken

Natürliche Sprache kann mächtige Datenbankänderungen auslösen. Aktionen prüfen, Produktionszugriff vermeiden und Read-only/Projektgrenzen nutzen.

Lizenz und Kosten

Lizenz
MIT
Kosten
kostenlos

Der Server ist MIT-lizenziert. Kosten richten sich nach Neon-Konto, Ressourcenverbrauch, gewähltem Plan und KI-Client.

Alternativen

Noch nicht erfasst.

Auf einen Blick

Anbieter
Neon
Status
Offizieller Server
Betriebsart
Remote
Aktuelle Version
Noch nicht erfasst.
GitHub-Sterne
665
Zuletzt geprüft
07.09.2026

Repository und Dokumentation

Kategorien

Unterstützte Clients

Passende Ratgeber

Anleitungen und Hintergrund, die zu diesem Eintrag passen.

Noch keine passenden Ratgeber vorhanden.