Neon Automatisierung
Automatisieren Sie Ihre Neon serverless Postgres-Workflows – listen Sie Projekte und Branches auf, überprüfen Sie Datenbanken, rufen Sie Verbindungs-URIs ab, verwalten Sie Rollen und integrieren Sie Neon-Datenbankoperationen in übergreifende Anwendungspipelines.
Toolkit-Dokumentation: composio.dev/toolkits/neon
Einrichtung
- Fügen Sie den Composio MCP-Server zu Ihrem Client hinzu:
https://rube.app/mcp - Verbinden Sie Ihr Neon-Konto, wenn Sie dazu aufgefordert werden (API-Schlüssel-Authentifizierung)
- Beginnen Sie mit der Nutzung der untenstehenden Workflows
Kern-Workflows
1. Projekte auflisten
Verwenden Sie NEON_RETRIEVE_PROJECTS_LIST, um alle Projekte zu entdecken, die dem authentifizierten Benutzer zugeordnet sind.
Tool: NEON_RETRIEVE_PROJECTS_LIST
Eingaben:
- org_id: string (ERFORDERLICH bei Verwendung eines persönlichen API-Schlüssels)
- limit: integer (1-400, Standard 10)
- cursor: string (Paginierungs-Cursor aus der vorherigen Antwort)
- search: string (Suche nach Projektname oder ID, unterstützt Teilmengen)
- timeout: integer (Millisekunden; gibt bei Zeitüberschreitung Teilergebnisse zurück)
Wichtig: Bei Verwendung eines persönlichen API-Schlüssels ist org_id erforderlich. Rufen Sie diese zuerst über NEON_GET_USER_ORGANIZATIONS ab.
2. Projektdetails abrufen
Verwenden Sie NEON_ACCESS_PROJECT_DETAILS_BY_ID, um die Projektkonfiguration, Besitzerinformationen und Verbrauchskennzahlen einzusehen.
Tool: NEON_ACCESS_PROJECT_DETAILS_BY_ID
Eingaben:
- project_id: string (erforderlich) -- Format: "Adjektiv-Nomen-Zahl", z.B. "dry-smoke-26258271"
3. Branches für ein Projekt auflisten
Verwenden Sie NEON_GET_BRANCHES_FOR_PROJECT, um Branches (Entwicklungsstufen) innerhalb eines Projekts aufzulisten.
Tool: NEON_GET_BRANCHES_FOR_PROJECT
Eingaben:
- project_id: string (erforderlich)
- search: string (optional, Suche nach Branch-Namen oder ID)
4. Datenbanken auf einem Branch auflisten
Verwenden Sie NEON_FETCH_DATABASE_FOR_BRANCH, um die Datenbanken in einem bestimmten Projekt und Branch zu inventarisieren.
Tool: NEON_FETCH_DATABASE_FOR_BRANCH
Eingaben:
- project_id: string (erforderlich)
- branch_id: string (erforderlich)
5. Verbindungs-URI abrufen
Verwenden Sie NEON_GET_PROJECT_CONNECTION_URI, um einen Postgres-Verbindungsstring für ein Projekt/Branch/Datenbank zu erhalten.
Tool: NEON_GET_PROJECT_CONNECTION_URI
Eingaben:
- project_id: string (erforderlich)
- database_name: string (erforderlich) -- z.B. "neondb"
- role_name: string (erforderlich) -- z.B. "neondb_owner"
- branch_id: string (optional, standardmäßig der Projekt-Standardbranch)
- endpoint_id: string (optional, standardmäßig der Lese-Schreib-Endpunkt)
- pooled: boolean (optional, fügt -pooler für Verbindungspooling hinzu)
Sicherheit: Der zurückgegebene URI enthält Anmeldeinformationen. Behandeln Sie ihn als Geheimnis – protokollieren oder teilen Sie ihn nicht.
6. Datenbankdetails und Rollen überprüfen
Verwenden Sie NEON_RETRIEVE_BRANCH_DATABASE_DETAILS, um eine Datenbank vor dem Verbinden zu überprüfen, und NEON_GET_BRANCH_ROLES_FOR_PROJECT, um verfügbare Rollen aufzulisten.
Tool: NEON_RETRIEVE_BRANCH_DATABASE_DETAILS
Eingaben:
- project_id: string (erforderlich)
- branch_id: string (erforderlich)
- database_name: string (erforderlich)
Tool: NEON_GET_BRANCH_ROLES_FOR_PROJECT
Eingaben:
- project_id: string (erforderlich)
- branch_id: string (erforderlich)
Bekannte Fallstricke
| Fallstrick | Detail |
|---|---|
| org_id erforderlich | NEON_RETRIEVE_PROJECTS_LIST gibt HTTP 400 "org_id is required" zurück, wenn ein persönlicher API-Schlüssel verwendet wird. Rufen Sie zuerst NEON_GET_USER_ORGANIZATIONS auf. |
| Unvollständige Paginierung | Projektlisten können ohne Paginierung unvollständig sein. Iterieren Sie mit cursor, bis dieser leer ist. |
| Ratenbegrenzung | NEON_RETRIEVE_PROJECTS_LIST gibt bei stoßweisem Auflisten HTTP 429 zurück. Vermeiden Sie redundante Aufrufe und warten Sie vor dem erneuten Versuch. |
| Ungültige Rollen-/Datenbankpaarung | NEON_GET_PROJECT_CONNECTION_URI gibt 401/403 zurück, wenn die Paarung von database_name und role_name ungültig ist. Verwenden Sie NEON_GET_BRANCH_ROLES_FOR_PROJECT, um eine zulässige Rolle auszuwählen. |
| Verbindungs-URI ist ein Geheimnis | Der zurückgegebene URI enthält Anmeldeinformationen. Protokollieren, anzeigen oder teilen Sie ihn niemals im Klartext. |
Schnellreferenz
| Tool Slug | Beschreibung |
|---|---|
NEON_RETRIEVE_PROJECTS_LIST | Alle Neon-Projekte mit Paginierung und Suche auflisten |
NEON_ACCESS_PROJECT_DETAILS_BY_ID | Projektkonfiguration und Verbrauchskennzahlen abrufen |
NEON_GET_BRANCHES_FOR_PROJECT | Branches innerhalb eines Projekts auflisten |
NEON_FETCH_DATABASE_FOR_BRANCH | Datenbanken in einem bestimmten Branch auflisten |
NEON_GET_PROJECT_CONNECTION_URI | Postgres-Verbindungs-URI (mit Anmeldeinformationen) abrufen |
NEON_RETRIEVE_BRANCH_DATABASE_DETAILS | Datenbankmetadaten und -einstellungen überprüfen |
NEON_GET_USER_ORGANIZATIONS | Organisationen für den authentifizierten Benutzer auflisten |
NEON_CREATE_API_KEY_FOR_ORGANIZATION | Neuen API-Schlüssel für eine Organisation erstellen |
NEON_GET_BRANCH_ROLES_FOR_PROJECT | Verfügbare Rollen auf einem Branch auflisten |
Bereitgestellt von Composio