@mockzilla/mcp

MCP-Server für mockzilla. Ermöglicht Agents wie Claude Desktop und Cursor, Mockzilla im Namen eines Benutzers zu steuern – und hilft Benutzern dabei, Mockzilla auszuprobieren, ohne dass sie zuerst ein Konto benötigen.

Die Bridge stellt zwei Ebenen von Tools bereit:

• Lokale Ebene (kein Konto): Überprüfen, ob die Mockzilla-CLI installiert ist, sie für den Benutzer installieren (vorgefertigte Binärdatei, go install oder go run), einen Blick auf eine OpenAPI-Spezifikation werfen und portable Mock-Server lokal ausführen. Nichts verlässt den Rechner des Benutzers.

• Gehostete Ebene (mit Konto): Wird an den MCP-Endpunkt von mockzilla.org weitergeleitet, wenn MOCKZILLA_TOKEN gesetzt ist. Sims auflisten, Bundles aus dem Katalog bereitstellen usw.

Ohne Token ist die lokale Ebene der gesamte Funktionsumfang – Agents können Benutzern weiterhin helfen, Mockzilla zu erkunden, bevor sie sich registrieren.

Installation

Claude Code

Einzeiler, keine Konfigurationsbearbeitung:

claude mcp add -s user mockzilla -- npx -y @mockzilla/mcp@latest

-s user installiert es für Ihr Benutzerkonto (verfügbar in jedem Projekt). Lassen Sie -s user weg, um es nur auf das aktuelle Projekt zu beschränken.

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Cursor

Am einfachsten: Cursor Settings → MCP Servers → Add new MCP server, dann ausfüllen:

• Name: mockzilla

• Command: npx

• Args: -y @mockzilla/mcp@latest

Oder bearbeiten Sie ~/.cursor/mcp.json direkt:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Gemini CLI

Einzeiler, keine Konfigurationsbearbeitung:

gemini mcp add -s user mockzilla npx -y @mockzilla/mcp@latest

-s user schreibt in ~/.gemini/settings.json (verfügbar in jedem Projekt). Lassen Sie -s user weg (oder verwenden Sie -s project), um es auf die .gemini/settings.json des aktuellen Verzeichnisses zu beschränken.

Oder bearbeiten Sie die Einstellungsdatei direkt:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Starten Sie den Client nach dem Bearbeiten der Konfiguration neu.

Warum @latest? Ohne diesen Zusatz speichert npx die erste aufgelöste Version im Cache und erkennt neue Veröffentlichungen nicht. Durch das Festlegen auf @latest prüft npx bei jedem Start erneut die Registry, sodass ein Neustart von Claude Desktop / Cursor ausreicht, um ein Upgrade durchzuführen. Nachteil: ca. 200 ms zusätzlicher Startaufwand.

Was Sie fragen können

Ohne Token (lokale Ebene):

• "Ist die Mockzilla-CLI installiert?"

• "Installiere Mockzilla für mich." (Agent fragt nach: Download / go-install / go-run)

• "Starte die Petstore-Spezifikation lokal, damit ich sie per curl abrufen kann."

• "Welche Endpunkte hat https://example.com/openapi.yaml?"

• "Stoppe den Mock, den du gestartet hast."

Mit Token (gehostete Ebene hinzugefügt):

• "Liste die Sims auf, die ich bereitgestellt habe."

• "Zeige mir die Katalogprodukte."

• "Stelle eine Stripe-Sandbox namens stripe-test bereit und warte auf die Live-URL."

• "Erstelle einen Mock aus dieser OpenAPI-URL auf Mockzilla."

Tools

Lokal

Gehostet

Verfügbar, wenn MOCKZILLA_TOKEN gesetzt ist. Wird an mockzilla.org weitergeleitet. Siehe die Dokumentation des gehosteten Servers für die Liste der Live-Tools – zum Zeitpunkt der Erstellung umfasst dies get_context, list_sims, list_catalog_products, deploy_mock_from_{catalog,spec,url} und wait_for_deploy.

Konfiguration

Cache

Die Bridge speichert alles unter ~/.cache/mockzilla-mcp/:

~/.cache/mockzilla-mcp/
├── bin/mockzilla        # downloaded or go-installed binary
├── config.json          # {method, version, invocation?}
└── mocks/               # mock_endpoint persists static endpoints here
    └── static/
        └── <service>/<path>/<method>/index.<ext>

rm -rf ~/.cache/mockzilla-mcp setzt die Bridge vollständig zurück (Binärdatei + alle gemockten Endpunkte). Um nur die Mocks zu löschen: rm -rf ~/.cache/mockzilla-mcp/mocks. Der System-PATH wird nie berührt, daher hat ein Zurücksetzen keine Auswirkungen auf eine separate Brew-Installation.

Updates

Die Bridge wird häufig aktualisiert; empfohlene Vorgehensweise, um auf dem neuesten Stand zu bleiben:

1. Legen Sie @mockzilla/mcp@latest in Ihrer MCP-Client-Konfiguration fest (siehe Installations-Snippets oben), damit npx bei jedem Start die Registry erneut prüft.

2. Starten Sie Claude Desktop / Cursor regelmäßig neu – dann wird die neue Version abgerufen.

3. Wenn etwas nicht funktioniert, fragen Sie den Agenten: "Führe bridge_status aus und sage mir, ob mockzilla-mcp auf dem neuesten Stand ist." Wenn es veraltet ist, führen Sie npx clear-npx-cache @mockzilla/mcp aus und starten Sie Ihren Client neu.

Die Mockzilla-CLI-Version wird von der Bridge festgelegt (MOCKZILLA_VERSION in lib/install.js). Ein Update der Bridge aktualisiert die Version; der nächste install_cli-Aufruf bringt die CLI selbst auf den neuesten Stand.

Entwicklung

Siehe CLAUDE.md für Projektkonventionen und eine Anleitung zum Hinzufügen eines neuen Tools.

Lizenz

MIT.