Wagtail MCP

🚧 это первый черновик прототипа MCP-сервера для Wagtail, написанный в стиле vibe-coding. Действуйте с осторожностью! Пока он не готов, возможно, вам стоит использовать wagtail-cli. См. CMS с ИИ, а не ИИ-CMS: новый API Wagtail 8.0 для контекста.

Сервер Model Context Protocol (MCP) для Wagtail, предоставляющий API Wagtail v3 как инструменты, вызываемые моделями. Направьте агента в стиле Claude/OpenCode/Hermes на сайт Wagtail и позвольте ему читать контент, создавать страницы, загружать изображения, публиковать и откатывать — через те же аутентифицированные операции, которые предоставляет API v3.

Что он даёт

• 60 курируемых инструментов, покрывающих всю поставляемую поверхность операций v3: страницы (включая ревизии, перемещение/копирование/откат, псевдонимы, переводы), изображения, документы, сниппеты, редиректы, сайты и локали — плюс api_call / api_schema, запасной выход на основе OpenAPI для всего остального.

• Внутрипроцессная диспетчеризация — инструменты вызывают смонтированный API v3 внутри процесса через тестовый клиент Django, поэтому аутентификация, права, валидация и логика действий являются настоящими. Никаких сетевых переходов, никакого наполовину переписанного клиента.

• Аутентификация по Bearer-токену с APIToken Wagtail; API v3 остаётся единственным авторитетом для авторизации.

• Stateless Streamable HTTP — представление Django, работающее под WSGI и ASGI, без дополнительных процессов.

Related MCP server: Umbraco CMS MCP Server

Быстрый старт

wagtail-mcp — это приложение Django: добавьте wagtail.api.v3 и wagtail_mcp, смонтируйте /api/v3/ и /mcp/, создайте API-токен, укажите клиенту на /mcp/. См. полное руководство по началу работы.

Направьте удалённый MCP-клиент на конечную точку:

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

Попробуйте демо

В репозитории есть demo/, сайт Wagtail, который монтирует и API, и конечную точку MCP и создаёт демо-токен:

just demo

Затем используйте токен из demo/ (см. demo/README.md) в конфигурации вашего клиента. Тест редакционного сценария — это полный рабочий пример, которому может следовать агент.

Документация

• Начало работы

• Справочник инструментов — все 60 инструментов, сгруппированных по ресурсам.

• Конфигурация — настройки, развёртывание, безопасность токенов.

• Запасной выход — api_call / api_schema.

• Ограничения

• Обратная связь по API

Поддерживаемые версии

Этот пакет поддерживает Wagtail 8.0 и выше (предварительная версия API v3), Django 5.2/6.0, и совместимые версии Python.

Разработка

Установите зависимости, запустите тесты, проверьте линтер и запустите демо (asgiref.sync обрабатывает транспорт, поэтому just test и just lint — обычные проверки):

just install
just test
just lint
just demo

См. CONTRIBUTING.md для полного рабочего процесса внесения вклада, включая набор оценок поведения агента.