Wagtail MCP

🚧 este es el primer borrador "vibe-coded" de un prototipo de servidor MCP para Wagtail. ¡Procede con precaución! Hasta que esté listo, quizás prefieras usar wagtail-cli. Consulta CMS con IA, no IA CMS: la nueva API de Wagtail 8.0 para más contexto.

Un servidor de Protocolo de Contexto de Modelo (MCP) para Wagtail, que expone la API v3 de Wagtail como herramientas invocables por modelos. Apunta un agente estilo Claude/OpenCode/Hermes a un sitio Wagtail y deja que lea contenido, cree páginas, suba imágenes, publique y revierta — a través de las mismas operaciones autenticadas que proporciona la API v3.

Lo que te ofrece

• 60 herramientas seleccionadas que cubren toda la superficie de operaciones v3 incluidas: páginas (incl. revisiones, mover/copiar/revertir, alias, traducciones), imágenes, documentos, fragmentos, redirecciones, sitios y locales — además de api_call / api_schema, una vía de escape respaldada por OpenAPI para cualquier otra cosa.

• Despacho en proceso — las herramientas llaman a la API v3 montada dentro del proceso mediante el cliente de pruebas de Django, por lo que la autenticación, los permisos, la validación y la lógica de acción son reales. Sin salto de red, sin cliente medio reimplementado.

• Autenticación por token Bearer con APIToken de Wagtail; la API v3 sigue siendo la única autoridad para la autorización.

• HTTP Streamable sin estado — una vista de Django que funciona bajo WSGI y ASGI, sin procesos adicionales.

Related MCP server: Umbraco CMS MCP Server

Inicio rápido

wagtail-mcp es una aplicación de Django: añade wagtail.api.v3 y wagtail_mcp, monta /api/v3/ y /mcp/, crea un token de API, apunta un cliente a /mcp/. Consulta la guía de inicio completa.

Apunta un cliente MCP remoto al endpoint:

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

Prueba la demo

El repositorio incluye demo/, un sitio Wagtail que monta tanto la API como el endpoint MCP y siembra un token de demostración:

just demo

Luego usa el token de demo/ (consulta demo/README.md) en la configuración de tu cliente. La prueba de escenario editorial es un ejemplo completo que un agente puede seguir.

Documentación

• Inicio rápido

• Referencia de herramientas — las 60 herramientas, agrupadas por recurso.

• Configuración — ajustes, despliegue, seguridad de tokens.

• Vía de escape — api_call / api_schema.

• Limitaciones

• Comentarios sobre la API

Versiones compatibles

Este paquete es compatible con Wagtail 8.0 y superiores (la vista previa de la API v3), Django 5.2/6.0, y las versiones de Python compatibles.

Desarrollo

Instala las dependencias, ejecuta las pruebas, lint y ejecuta la demo (asgiref.sync maneja el transporte, así que just test y just lint son los pasos habituales):

just install
just test
just lint
just demo

Consulta CONTRIBUTING.md para el flujo de contribución completo, incluida la suite de evaluación del comportamiento del agente.