Wagtail MCP

🚧 이것은 Wagtail용 MCP 서버 프로토타입의 첫 번째 vibe-coded 초안입니다. 주의해서 진행하세요! 준비될 때까지는 wagtail-cli를 사용하는 것이 좋을 수 있습니다. 맥락은 CMS with AI, not AI CMS: Wagtail 8.0’s new API를 참조하세요.

Wagtail용 Model Context Protocol(MCP) 서버로, Wagtail v3 API를 모델 호출 가능한 도구로 노출합니다. Claude/OpenCode/Hermes 스타일 에이전트를 Wagtail 사이트에 연결하여 콘텐츠 읽기, 페이지 생성, 이미지 업로드, 게시 및 되돌리기 등을 v3 API가 제공하는 동일한 인증 작업을 통해 수행할 수 있습니다.

제공 기능

• 60개의 선별된 도구 — 전체 v3 작업 표면을 포함: 페이지(개정, 이동/복사/되돌리기, 별칭, 번역 포함), 이미지, 문서, 스니펫, 리디렉션, 사이트 및 로케일 — 그리고 그 외 모든 것을 위한 OpenAPI 기반 탈출구인 api_call / api_schema도 포함.

• 프로세스 내 디스패치 — 도구가 Django 테스트 클라이언트를 통해 프로세스 내에서 마운트된 v3 API를 호출하므로 인증, 권한, 검증 및 작업 로직이 실제 그대로입니다. 네트워크 홉 없음, 절반만 재구현된 클라이언트 없음.

• Bearer 토큰 인증 — Wagtail APIToken 사용; v3 API가 권한 부여의 단일 권위자로 유지됩니다.

• 상태 없는 Streamable HTTP — WSGI 및 ASGI에서 작동하는 Django 뷰로, 추가 프로세스가 필요 없습니다.

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/가 포함되어 있으며, API와 MCP 엔드포인트를 모두 마운트하고 데모 토큰을 시드하는 Wagtail 사이트입니다:

just demo

그런 다음 클라이언트 구성에서 demo/의 토큰(demo/README.md 참조)을 사용하세요. 편집 시나리오 테스트는 에이전트가 따라할 수 있는 완전한 작업 예제입니다.

문서

• 시작하기

• 도구 참조 — 리소스별로 그룹화된 60개 도구 전체.

• 구성 — 설정, 배포, 토큰 보안.

• 탈출구 — api_call / api_schema.

• 제한 사항

• API 피드백

지원 버전

이 패키지는 Wagtail 8.0 이상(v3 API 미리보기), Django 5.2/6.0, 그리고 호환되는 Python 버전을 지원합니다.

개발

의존성 설치, 테스트 실행, 린트, 데모 실행(asgiref.sync가 전송을 처리하므로 just test와 just lint가 일반적인 게이트입니다):

just install
just test
just lint
just demo

전체 기여 워크플로우(에이전트 동작 평가 스위트 포함)는 CONTRIBUTING.md를 참조하세요.