Wagtail MCP

🚧 Dies ist der erste vibe-codierte Entwurf eines MCP-Server-Prototyps für Wagtail. Vorsicht ist geboten! Bis dies fertig ist, solltest du vielleicht wagtail-cli verwenden. Siehe CMS mit KI, nicht KI-CMS: Wagtail 8.0s neue API für den Kontext.

Ein Model Context Protocol (MCP)-Server für Wagtail, der die Wagtail-v3-API als modellaufrufbare Tools bereitstellt. Richte einen Claude/OpenCode/Hermes-artigen Agenten auf eine Wagtail-Site aus und lass ihn Inhalte lesen, Seiten erstellen, Bilder hochladen, veröffentlichen und zurücksetzen – über dieselben authentifizierten Operationen, die die v3-API bietet.

Was es dir bietet

• 60 kuratierte Tools, die die gesamte ausgelieferte v3-Operationsfläche abdecken: Seiten (inkl. Revisionen, Verschieben/Kopieren/Zurücksetzen, Aliase, Übersetzungen), Bilder, Dokumente, Snippets, Weiterleitungen, Sites und Locales – plus api_call / api_schema, eine OpenAPI-gestützte Notluke für alles andere.

• In-Process-Dispatch – Tools rufen die gemountete v3-API innerhalb des Prozesses über den Testclient von Django auf, sodass Authentifizierung, Berechtigungen, Validierung und Aktionslogik echt sind. Kein Netzwerk-Hop, kein halb neu implementierter Client.

• Bearer-Token-Authentifizierung mit Wagtail APIToken; die v3-API bleibt die alleinige Autorität für die Autorisierung.

• Zustandsloses Streamable HTTP – eine Django-View, die unter WSGI und ASGI funktioniert, ohne zusätzliche Prozesse.

Related MCP server: Umbraco CMS MCP Server

Schnellstart

wagtail-mcp ist eine Django-App: Füge wagtail.api.v3 und wagtail_mcp hinzu, mounte /api/v3/ und /mcp/, erstelle ein API-Token und richte einen Client auf /mcp/ aus. Siehe die vollständige Erste Schritte-Anleitung.

Richte einen entfernten MCP-Client auf den Endpunkt aus:

{
  "mcp": {
    "wagtail": {
      "type": "remote",
      "url": "http://localhost:8000/mcp/",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "Content-Type": "application/json"
      }
    }
  }
}

Demo ausprobieren

Das Repository enthält demo/, eine Wagtail-Site, die sowohl die API als auch den MCP-Endpunkt mountet und ein Demo-Token bereitstellt:

just demo

Verwende dann das Token von demo/ (siehe demo/README.md) in deiner Client-Konfiguration. Der Editorial-Szenario-Test ist ein vollständiges, durchgearbeitetes Beispiel, dem ein Agent folgen kann.

Dokumentation

• Erste Schritte

• Tool-Referenz – alle 60 Tools, gruppiert nach Ressource.

• Konfiguration – Einstellungen, Bereitstellung, Token-Sicherheit.

• Notluke – api_call / api_schema.

• Einschränkungen

• API-Feedback

Unterstützte Versionen

Dieses Paket unterstützt Wagtail 8.0 und höher (die v3-API-Vorschau), Django 5.2/6.0 und die kompatiblen Python-Versionen.

Entwicklung

Installiere Abhängigkeiten, führe die Tests aus, lint und starte die Demo (asgiref.sync übernimmt den Transport, also sind just test und just lint die üblichen Tore):

just install
just test
just lint
just demo

Siehe CONTRIBUTING.md für den vollständigen Beitrags-Workflow, einschließlich der Eval-Suite für das Agentenverhalten.