OpenToonz MCP

---

これを作った理由

現在の「AIアニメーション」の大半は、編集できない完成動画を生成します。アニメーターに必要なのはその逆です。修正できる作画、調整できるタイミング、そして制作パイプラインの次の担当者に引き継げるシーンです。

OpenToonzは、Studio Ghibliがカスタマイズし、映画制作に使用したソフトウェアToonzのオープンソース版です。ベクターレベル、Xsheet、ペグバー、カメラ、コンポジターなど、2D制作パイプラインに必要なものはすでにすべて備えています。足りなかったのは、アシスタントがそれを使う方法でした。

OpenToonz MCPは、その橋渡しをします。ショットの内容を伝えると、アシスタントがレイアウトを作成し、キーとなるポーズを描き、中割りを作成し、1コマ打ち、2コマ打ち、または3コマ打ちでタイミングを設定し、カメラワークを加えてレンダリングします。できあがるのは通常のOpenToonzシーンです。シーンを開いて、好きなところを変更し、保存して、アシスタントに続きを頼めます。加えた編集内容は保持されます。

— konkomaji · konkomaji.com

対象となる方

• アニメーターや監督。素早く作成したレイアウト、アニマティクス、中割り、カメラワークを、あとから手作業で仕上げたい方。
• インディーズスタジオや個人クリエイター。大規模なスタッフを揃えずに、短編、解説動画、ミュージックビデオ、ゲームのカットシーンを制作したい方。
• アニメーションの教師や学生。ツールはクラシックな原則（スローイン／スローアウト、弧、予備動作、フォロースルー）に沿っているため、出力をフレームごとに確認できる実例として活用できます。
• 開発者。ピクセル画像ではなく、実際に確認できる2D制作パイプラインを必要とするクリエイティブAIツールを開発している方。

できること

🎨 ネイティブなベクター描画	図形、SVG パス、筆圧に応じたブラシストロークを OpenToonz のベクターレベル .pli に変換します。変換は OpenToonz 自身が行うため、描画は OpenToonz のベクターツールで完全に編集できます。
✍️ 手描き風の表現	筆圧に応じた線の強弱。静止フレームでは揺れが止まる、さりげない線の揺らぎ。任意で線のボイルも追加できます。アニメのセル影やペンのハッチング（p5.brush に着想を得たもの）、色付きのトレース線にも対応しています。スタイルプリセット：anime、feature、cartoon、sketch、clean。
🎞️ アニメーター向けのタイミング	スローイン・スローアウト、弧を描く動き、面積を一定に保つスクワッシュ＆ストレッチを加えた中割り。Xsheet の露出は 1 コマ打ち、2 コマ打ち、3 コマ打ちから選べます。テキストからまばたきやリップシンクを作成します。
🦘 原則を組み込んだアニメーション	animate_action は、クラシックな比率を使って予備動作、オーバーシュート、収まりを追加します。物理演算ツールでは、重力に正確に従ったバウンド（素材プリセット付き）、レシピに基づくジャンプ、髪、尻尾、布のバネベースの後続動作を作成できます。
🧍 歩行・走行する実在の人体	build_character は、公表された身体計測値をもとに、あらゆる年齢・性別（幼児、女児、男児、10代、女性、男性、老女、老人）の横向きカットアウトリグを作成します。必要に応じて、各国の健康調査に基づく地域別平均値（米国、インド、西ベンガル、日本、英国、ナイジェリアなど）も利用できます。walk_cycle と run_cycle は歩容研究に基づいてアニメーションを作成します。かかとからつま先へ転がる接地した足、2 ボーンの脚 IK、倒立振子モデルの歩行、空中で重力に正確に従うばね質点モデルの走行に対応しています。各呼び出しでは、動きの確認に役立つ歩調、歩幅、膝の角度、足の滑りを報告します。
🎬 スタジオ風のルック	apply_look は、ghibli、klaus、spider_verse、comic、anime_satsuei、painterly、cartoon_saloon のルックを、OpenToonz の実際の FX ノード（ブルーム、形状影とリムライト、色版のずらし、粒子）として追加します。FX Schematic で引き続き編集でき、remove_look で問題なく取り除けます。
🎥 カメラワーク	視差レイヤーを使ったパン、指数関数的なトラック移動、衝撃やトラウマによる揺れ、滑らかなカメラ追従に対応します。動きによって空の背景が見える場合や、ストロボのように見えるほど速くパンする場合は、事前に警告します。
🖼️ 手持ちのアートを利用	SVG ファイルを編集可能な図形としてインポートします。画像を配置したり、OpenToonz 独自のベクタライザーでトレースしてベクターレベルに変換したりできます。バリエーション（口のチャートなど）を含むモデルシートで、再利用可能なパーツライブラリを構築できます。
🔁 手作業での編集にも対応	シーンファイルが唯一の正本です。OpenToonz でタイミングを変更したり描き直したりして保存すると、アシスタントは変更を上書きせずに取り込みます。
🛡️ 安全性を重視した設計	編集の前には必ずスナップショットを作成します。呼び出しに失敗した場合は自動的にロールバックします。undo はシーンと描画を正確に復元し、書き込みは反映前に検証され、シーンごとのロックで同時書き込みを防ぎます。
🧠 記憶して改善	シーンごとにメモとジャーナルを保持します。エラー、レンダリングのレビュー、ユーザーからのフィードバックは優先順位付きの教訓となり、後のセッションで参照されます。また、tune_style を使うと、好みのデフォルト設定を恒久的に適用できます。

セル影、揺らぎ、筆圧に応じた線の強弱を OpenToonz でレンダリング	SVG パスと、各ポイントに筆圧を設定したブラシストローク

必要条件

• Windows 版 OpenToonz 1.8。サーバーは OpenToonz のレジストリエントリからインストール先と「stuff」フォルダーを自動検出します。
• Python 3.10 以降。
• MP4 および GIF 出力には PATH 上の ffmpeg が必要です（PNG シーケンスは ffmpeg がなくても使用できます）。

インストール

pip install opentoonz-mcp
# or run without installing:
uvx opentoonz-mcp

pip 26.2.2 以上、または uv 0.13.4 以上を使用してください。 古いバージョンは、2026年10月のeMudhraインシデントの後に失効したemSign認証局を引き続き信頼します。まず、python -m pip install --upgrade pip certifi または UV_SYSTEM_CERTS=true uv self update でアップグレードしてください。パッケージ自体には certifi>=2026.10.19 が必要です。

Claude Code

claude mcp add opentoonz -- uvx opentoonz-mcp

Claude Desktop、Cursor、その他のMCPクライアント

{
  "mcpServers": {
    "opentoonz": {
      "command": "uvx",
      "args": ["opentoonz-mcp"],
      "env": {
        "OPENTOONZ_HOME": "C:\\Program Files\\OpenToonz",
        "OPENTOONZ_STUFF": "C:\\OpenToonz stuff"
      }
    }
  }
}

env ブロックは省略可能です。自動検出で誤ったインストール先が選ばれる場合にのみ使用してください。

変数	意味	デフォルト
OPENTOONZ_HOME	OpenToonz.exe と tcomposer.exe があるフォルダー	Windowsのアンインストール情報から検出し、次に C:\Program Files\OpenToonz
OPENTOONZ_STUFF	OpenToonz の「stuff」フォルダー（TOONZROOT）	HKLM\SOFTWARE\OpenToonz\OpenToonz から検出
OTMCP_WORK	状態、取り消し用スナップショット、レンダリング、レッスンの保存先	%LOCALAPPDATA%\opentoonz-mcp

まず opentoonz_info を実行するようアシスタントに依頼してください。検出された内容と不足しているものが報告されます。

試してみる

丘の上にいる丸い餅キャラクターの、4秒間のアニメ風シーンを作成してください。まばたきし、しゃがんで、ジャンプして着地する動きにスクワッシュ＆ストレッチを加え、カメラはパララックスを伴って右にパンします。その後、MP4をレンダリングしてください。

スケッチ C:\art\pose.png を中心線トレースでトレースレイヤーに読み込み、次のキーに向けて2コマ打ちで中割りを作成してください。

おばあさんと7歳の女の子を作成し、2人で画面を横切って歩かせてください。

OpenToonzでシーンを開いてください。12フレーム目の腕は私が直します。…完了です。13フレーム目から続けてください。

適切なセッションは、スタジオの制作パイプラインのように進みます。

1. scene_context（必ず最初に実行）
2. create_scene
3. add_note（ストーリー）
4. レイアウト：レイヤー、ペグ、カメラ
5. キー作画、その後に inbetween とタイミング
6. set_pivot、次にキー、animate_action と物理演算（人物の場合は build_character と walk_cycle）
7. camera_move、次に apply_look でスタジオ品質に仕上げる
8. validate_scene、contact_sheet、render

全52個のツールと各パラメーターについては、docs/TOOLS.md をご覧ください。

仕組み

assistant ──MCP──► opentoonz-mcp ──► .tnz scene (edited in place, lossless)
                         │
                         ├─► SVG drawings ──► OpenToonz.exe (headless script) ──► native .pli ──► pen pressure
                         ├─► images ───────► OpenToonz vectorizer ───────────────► traced .pli
                         └─► tcomposer.exe (OpenToonz's renderer) ──► PNG ──► ffmpeg ──► MP4 / GIF

OpenToonzのデータに関わる処理はすべて、OpenToonz自体と照合して検証されます。たとえば、キーフレーム補間はOpenToonzの評価処理を移植したもので、実際の tcomposer レンダリングとフレームごとに比較するテストが行われます（誤差は1.5 px以内です）。

詳細は、docs/WHITEPAPER.md、docs/ARCHITECTURE.md、docs/FORMAT_NOTES.mdをご覧ください。

制限事項

• まずはWindows向けです。 OpenToonz 1.8を使用してWindows上で開発・テストされています。OPENTOONZ_HOME を設定すれば他のプラットフォームでも動作する可能性がありますが、テストされていません。
• 作画には図形、パス、ブラシストローク、インポートしたアートを使用します。 画像生成機能は組み込まれていません。アートを用意するか、アシスタントにパスやパーツから構成させてください。
• 再描画すると、そのレイヤーの編集内容が置き換わります。 GUIでアシスタントが描いたレイヤーを再描画した場合、force=true を指定しない限り、アシスタントが上書きすることはありません。
• レンダリングテストにはローカルのOpenToonzが必要です。 CIではユニットテストのみ実行されます。

貢献

Issueやプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。変更はCHANGELOG.mdに記録されています。

クレジット

• konkomaji が開発しました。
• OpenToonz（BSD-3-Clause）を使用しています。OpenToonzは同梱されていません。DWANGO、Digital Videoの元Toonzチーム、スタジオジブリ、そしてOpenToonzのすべての貢献者に感謝します。NOTICEをご覧ください。
• このプロジェクトはOpenToonz、DWANGO、Digital Video、スタジオジブリとは提携していません。

MIT Licenseの下で公開されています。