dynamic-pocketbase-mcp

Dynamischer Model Context Protocol (MCP)-Server für PocketBase. Verbinden Sie Ihren KI-Client einmal und verwalten Sie dann Sammlungen und Datensätze in jedem PocketBase-Projekt mithilfe von Laufzeit-Tools.

Warum dieser Server anders ist

Viele PocketBase MCP-Server sind statisch: Sie kodieren sammlungsspezifisches Verhalten fest oder erfordern benutzerdefinierte Tool-Definitionen pro Schema.

dynamic-pocketbase-mcp ist dynamisch:

• Verwendet sammlungsunabhängige Tools (list_collections, list_records, create_record usw.)

• Funktioniert über bestehende und neu erstellte Sammlungen hinweg, ohne den Server-Code neu generieren zu müssen

• Stellt Live-PocketBase-Sammlungen als MCP-Ressourcen bereit

Related MCP server: PocketBase MCP Server

Funktionen

• 18 MCP-Tools für Status, Authentifizierung, Sammlungen, Regeln und Datensätze

• Lebenszyklus-Operationen für Sammlungen (erstellen, aktualisieren, löschen, inspizieren)

• Datensatz-CRUD mit Filtern, Sortierung, Paginierung und Feldauswahl

• Sitzungsbasierte Authentifizierung über Tools (auth_admin, auth_user, get_auth_status, logout)

• Integrierte Referenzen für Feldschema und Regel-Syntax

Installation

npm install dynamic-pocketbase-mcp
# or
bun install dynamic-pocketbase-mcp

Konfiguration in einem KI-Client

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "dynamic-pocketbase": {
      "command": "npx",
      "args": ["-y", "dynamic-pocketbase-mcp"]
    }
  }
}

Wenn POCKETBASE_URL nicht gesetzt ist, verwendet der Server standardmäßig http://localhost:8090.

Direkte Verwendung

# Use default URL (http://localhost:8090)
npx -y dynamic-pocketbase-mcp

# Use custom PocketBase URL
POCKETBASE_URL=https://pb.example.com \
bunx dynamic-pocketbase-mcp

Einfaches Tutorial: Chatten mit KI unter Verwendung dieses MCP

Nachdem Sie Ihren MCP-Client konfiguriert haben, öffnen Sie einen Chat und versuchen Sie Prompts wie diese:

1. "Setze die PocketBase-URL auf https://pb.example.com."

2. "Überprüfe den Status meines PocketBase-Servers."

3. "Liste alle PocketBase-Sammlungen auf."

4. "Authentifiziere dich als Admin mit E-Mail <your-email> und Passwort <your-password>."

5. "Erstelle eine Sammlung namens notes mit einem erforderlichen title Textfeld."

6. "Erstelle einen Datensatz in notes mit dem Titel Erste Notiz."

7. "Zeige alle Datensätze in notes an, die neuesten zuerst."

8. "Melde dich von der PocketBase-Authentifizierungssitzung ab."

Wenn diese Schritte erfolgreich sind, kann Ihre KI nun Schema und Daten über diesen MCP-Server verwalten.

Authentifizierungsablauf (über Tools)

1. auth_admin oder auth_user

2. get_auth_status

3. logout

Verfügbare Tools

Status und Referenzen

• health - Überprüfe den Status des PocketBase-Servers

• set_base_url - Aktualisiere die PocketBase-URL für die aktuelle MCP-Sitzung und lösche das Authentifizierungs-Token

• get_field_schema_reference - Dokumentation zu Feldtypen abrufen

• get_rules_reference - Referenz zur API-Regel-Syntax abrufen

Authentifizierung

• auth_admin - Authentifizierung als Admin/Superuser

• auth_user - Authentifizierung als Benutzer einer Auth-Sammlung (E-Mail/Benutzername)

• get_auth_status - Aktuellen Authentifizierungsstatus überprüfen

• logout - Authentifizierungssitzung beenden

Sammlungen

• list_collections - Alle Sammlungen auflisten

• view_collection - Sammlung nach Name oder ID anzeigen

• create_collection - Neue Sammlung erstellen (fügt automatisch created und updated Datumsfelder für Basis-/Auth-Sammlungen hinzu, sofern nicht anders angegeben)

• update_collection - Sammlungsschema/-einstellungen aktualisieren

• delete_collection - Sammlung löschen

• update_collection_rules - Zugriffskontrollregeln aktualisieren

Datensätze

• list_records - Datensätze auflisten/suchen mit Filtern, Sortierung, Paginierung

• view_record - Einzelnen Datensatz nach ID anzeigen

• create_record - Neuen Datensatz erstellen

• update_record - Bestehenden Datensatz aktualisieren

• delete_record - Datensatz löschen

Entwicklung

# Install dependencies
bun install

# Run in development mode
bun run dev

# Type check
bun run typecheck

# Run tests (builds dist first)
bun run test

# Run all checks (typecheck + tests)
bun run check

# Interactive release helper (bump, check, publish, push tag)
bun run release

# Build for production
bun run build

Umgebungsvariablen

Lizenz

MIT