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を参照してください。