Inochi Creator MCP

起動中の Inochi Creator を、Cursor などから MCP 経由でライブ操作します。

Inochi Creator には公式のプラグイン／IPC がないため、v0_8 をソース改変して再ビルドする必要があります。itch.io / Steam の公式バイナリでは動きません。

構成

Cursor  --stdio MCP-->  このリポジトリの Node サーバー
                              |
                              | HTTP POST http://127.0.0.1:17320/rpc
                              v
                    パッチ済み Inochi Creator（UI スレッドで inc* API を実行）

待ち受けは 127.0.0.1 のみです。任意で INOCHI_MCP_TOKEN を Creator と MCP の両方に設定すると、Bearer / X-Inochi-Token 照合が入ります。

必要環境

• Node.js 18 以降
• Inochi Creator v0_8 のソースと、公式 README どおりのビルド環境
  • Windows: Visual Studio 2022（C++）、CMake、LDC または DMD

1. ブリッジを Creator に入れる

git clone --branch v0_8 --recursive https://github.com/Inochi2D/inochi-creator.git
# 依存関係は公式 README に従って準備する

.\scripts\apply-bridge.ps1 -CreatorRoot "C:\path\to\inochi-creator"

スクリプトは次を行います。

• creator-bridge/mcp/*.d を source/creator/mcp/ へコピー
• source/app.d に incMcpInit() / incMcpPoll() を挿入（再実行しても二重には入りません）

その後、Inochi Creator 側でいつもどおり dub ビルドして起動します。

curl http://127.0.0.1:17320/health

{"ok":true,...} が返ればブリッジは生きています。

ポートを変える場合は、Creator 起動前に INOCHI_MCP_PORT（デフォルト 17320）を設定し、MCP 側にも同じ値を渡してください。

2. MCP サーバーをビルドする

cd C:\Users\masam\Documents\inochi-creator-mcp
npm install
npm run build

開発中は npm run dev（tsx src/index.ts）でも起動できます。

3. Cursor に接続する

Cursor の MCP 設定例:

{
  "mcpServers": {
    "inochi-creator": {
      "command": "node",
      "args": ["C:/Users/masam/Documents/inochi-creator-mcp/dist/index.js"],
      "env": {
        "INOCHI_MCP_PORT": "17320"
      }
    }
  }
}

ログは stdout を汚さないよう stderr に出します。Creator が起動していないと、各ツールは「パッチ済み Inochi Creator を起動してください」と返します。

ツール

接続できないときは、パッチ済み Creator が 127.0.0.1:17320 で待っているか確認してください。

状態・プロジェクト

• creator_ping / creator_get_status
• creator_set_edit_mode（model / vertex / anim / test）
• creator_new_project / creator_open_project / creator_save_project
• creator_export_inp（エクスポート UI は開かず、デフォルト設定で .inp を書く）

ノード・パラメータ

• creator_list_nodes / creator_get_node / creator_select_node / creator_focus_camera
• creator_rename_node / creator_set_node_enabled / creator_set_node_transform
• creator_create_node（Node / Composite / MeshGroup / SimplePhysics / Camera）
• creator_duplicate_node / creator_delete_node / creator_reparent_node
• creator_list_parameters / creator_set_parameter / creator_arm_parameter / creator_disarm_parameter
• creator_add_parameter / creator_remove_parameter
• creator_undo / creator_redo

Part はテクスチャが必要なので、creator_import_images で PNG/TGA/JPEG から作ります。

取り込み

creator_import_psd / creator_import_kra / creator_import_inp / creator_import_folder は内部で新規プロジェクトを作るため、今開いているプロジェクトを置き換えます。

creator_import_images だけは現在のプロジェクトを維持し、選択中（または指定した親）の下に Part を足します。

アニメ・撮影

• creator_list_animations / creator_set_animation
• creator_play_animation / creator_pause_animation / creator_stop_animation / creator_seek_animation
• creator_add_keyframe / creator_remove_keyframe
• creator_capture_viewport — ビューポート PNG。既定では長辺 1024 に縮小。full: true で原寸。MCP の画像として返します。

対象外: メッシュ頂点編集、パラメータ binding の詳細、トラッキング、動画書き出し。

手動でブリッジを入れる場合

apply-bridge.ps1 を使わないときは、次を source/app.d に足します。

1. import creator.mcp;
2. 初期化のあと（incInitAtlassing(); の近く）に incMcpInit();
3. incUpdate() と incUpdateNoEv() の inUpdate(); の直後に incMcpPoll();

コマンド実行は必ず UI スレッド（incMcpPoll）側です。ソケット受信は別スレッドです。

プロトコル

POST /rpc HTTP/1.1
Host: 127.0.0.1:17320
Content-Type: application/json

{"method":"list_nodes","params":{"detail":false}}

{"ok":true,"result":{...}}

失敗時は {"ok":false,"error":"..."} です。