🔌 MCPサーバー

Claude Code連携ガイド

Model Context Protocolを通じてClaude CodeからAutoFlowCutを直接制御

🤖 MCPとは？

Model Context Protocol（MCP）を使用すると、Claude CodeからAutoFlowCutをターミナルで直接制御できます。CSVシーンの読み込み、プロンプトの更新、バッチ画像生成、CapCutへのエクスポートまで、すべて自然言語コマンドで実行可能です。

MCPサーバーはstdioを通じてClaude Codeと通信し、ローカルHTTP API（ポート3210）を通じて実行中のAutoFlowCutアプリに接続します。

🏗️ アーキテクチャ 

Claude Code ←→ MCP Server (stdio) ←→ Electron App (HTTP :3210)
                  ↕                            ↕
           CSV / project.json          React Renderer (IPC)
           .audio_review.json          State直接変更
1. CSV直接管理 — ディスク上のCSVとproject.jsonファイルの読み書き
2. HTTPアプリ制御 — localhost APIを通じて実行中のアプリ状態を直接操作

🧰 ツールカテゴリ

📊 CSV管理

CSVファイルからシーンの読み込み、一覧表示、検索、更新、保存を行います。プロンプトの一括更新やシーンフィールドの管理をサポートします。

load_csv list_scenes update_prompt save_csv

🖼️ リファレンスツール

project.jsonのキャラクターおよびシーンリファレンスを管理します。一覧表示、詳細確認、プロンプト更新をサポートします。

list_references get_reference update_reference_prompt

🎬 アプリ制御

HTTPを通じて実行中のアプリを制御します — app_* ツール19個とエクスポートツール2個。プロジェクト管理、画像生成、バッチ実行、ステータス監視、エクスポートを行います。以下は一部のみの表示です。

app_open_project app_generate_scene app_start_scene_batch app_wait_batch app_batch_status export_capcut export_premiere 他14個の app_*

🚦 ワークフロー進捗

パイプラインのウェーブ進捗を取得し、QAレビューの状況をアプリのバナーに通知します。進捗は読み取り専用で、記録はスキルが行います。

get_progress app_notify_qa

🧩 スキル管理

Claude Code用のAutoFlowCutスキルをインストール・一覧表示・削除します。インストール時にテンプレート変数が置換されます。

list_skills install_skill uninstall_skill

🎧 オーディオレビュー & スタイル

オーディオパッケージ内の不適合なナレーション・効果音ファイルにマークを付け外しし、内蔵のスタイルプリセットを閲覧します。

list_audio_reviews update_audio_review list_styles

📖 主要ツールリファレンス

ツール 説明
load_csv CSVファイルと画像ディレクトリを読み込み
list_scenes 範囲指定可能なシーン一覧表示
update_prompt 個別シーンの英語プロンプトを更新
batch_update_prompts 複数シーンのプロンプトを一括更新
app_start_scene_batch 保留中シーンのバッチ画像生成を開始
app_wait_batch バッチ生成完了まで待機（ロングポーリング）
export_capcut CapCutプロジェクトにエクスポート
export_premiere Premiere Proプロジェクト（.prproj）にエクスポート
get_schema CSV/SRT/オーディオスキーマドキュメントを取得
list_styles スタイルプリセットをカテゴリ別に一覧表示
get_progress パイプラインのウェーブ進捗を取得（読み取り専用）

🚦 ワークフロー進捗

9つのウェーブ（W1〜W9）のパイプラインはstory-engine Claude Codeスキルのものです — アプリ内蔵のストーリーモードではありません。内蔵のストーリーモードは台本 → シーン分割 → オーディオ → プロンプトの順に進み、ウェーブはありません。スキルのオーケストレーターが、プロジェクトの_story_source/フォルダ内のファイルにワークフロー状態を直接書き込みます。ワークフロー状態を書き込むMCPツールはありません — MCPサーバーはget_progressで読み取るだけです。

ワークフロー状態ファイル

ファイル 役割 書き込み主体
STATE.md メイン状態 — 現在のウェーブ、完了ステップ、決定事項 story-engineスキル
W{N}_SUMMARY.md ウェーブごとの結果、レビューラウンド、課題 story-engineスキル
W_progress.json サイドログ — アプリ・外部ツール用のwaves.W1〜waves.W9ステータス story-engineスキル（get_progressで取得）

使用方法

# W_progress.json からウェーブ進捗を取得
get_progress()

# QAレビューの進捗をアプリの上部バナーに通知
app_notify_qa(kind="scene", state="progress", current=12, total=40, round=1, issues=3)

🌐 HTTP APIエンドポイント

AutoFlowCutの設定でMCP HTTPサーバーを有効にすると、127.0.0.1:3210で利用可能になります。

メソッド パス 説明
GET /api/status サーバーヘルスチェック
GET /api/references リファレンス一覧（base64画像除外）
GET /api/scenes シーン一覧（画像データ除外）
GET /api/batch-status バッチ生成の進捗状況
POST /api/generate-reference リファレンス画像生成をトリガー
POST /api/generate-scene 個別シーン画像生成をトリガー
POST /api/start-batch 全バッチ生成を開始
POST /api/update 汎用ステート更新（IPC中継）

📚 関連ガイド

ファイルインポートガイド CapCutエクスポートガイド スキルガイド オーディオパッケージガイド ストーリーモードガイド