AviUtl2 Catalog Web
汎用プラグイン

aviutl2_mcp_bridge

概要

AviUtl2ライブ共同編集用MCPブリッジ

詳細説明

aviutl2-live-mcp

Live co-edit for AviUtl2 / ExEdit2: a native .aux2 plugin exposes the host edit API over TCP, and a Python MCP server lets AI agents drive the open timeline (Blender/Godot-style live editing).

Two installs, not one: Catalog / Plugin folder for the .aux2, uv/pip for the MCP.

License: MIT

Features

  • Live create / move / delete objects while AviUtl2 GUI is open
  • Text & shape helpers, media files, property get/set
  • Cursor, display frame, layer name / enable / lock
  • Localhost-only TCP (127.0.0.1:28551), single client
  • AviUtl2 Catalog install path for the plugin (.au2pkg + GitHub Releases)
  • MCP stdio tools for Claude, Cursor, Grok, and other hosts

Repository: https://github.com/TranczMeq/aviutl2-live-mcp

Quick start

1. Install the plugin

Catalog: search aviutl2_mcp_bridge or package id tranczmeq.aviutl2-mcp-bridge → Install → restart AviUtl2.
(If not listed yet, use manual install below. Maintainers: docs/CATALOG.md.)

Manual: copy aviutl2_mcp_bridge.aux2 from a Release to:

C:\ProgramData\aviutl2\Plugin\

Restart AviUtl2 and open a project.

2. Install the MCP server

pip install git+https://github.com/TranczMeq/aviutl2-live-mcp.git
# or clone and: pip install -e .
aviutl2-live-ping    # should print pong + edit info

3. Point your agent at it

{
  "mcpServers": {
    "aviutl2-live": {
      "command": "aviutl2-live-mcp"
    }
  }
}

More: docs/MCP.md · docs/INSTALL.md

Architecture

  Agent  ──stdio MCP──►  aviutl2-live-mcp (Python)
                              │
                         TCP 127.0.0.1:28551
                              │
  AviUtl2  ◄── aviutl2_mcp_bridge.aux2 ──  EDIT_HANDLE / EDIT_SECTION

This is not a headless file builder. For offline .aup2 generation, use a separate Path A / aviutl2-api workflow.

Documentation

Doc Topic
docs/INSTALL.md Plugin + Python install
docs/CATALOG.md Catalog .au2pkg packaging & registration
docs/MCP.md Tools & IDE config
docs/PROTOCOL.md Wire protocol
docs/BUILD.md Build .aux2 from source
docs/TROUBLESHOOTING.md Common failures
docs/ja/README.md 日本語まとめ

Repository layout

plugin/           Native bridge source + vendored SDK headers
src/aviutl2_live/ Python client + MCP server
catalog/          Catalog package metadata (for maintainers)
scripts/          build_au2pkg.py — zip for Catalog / Releases
docs/             User documentation
examples/         Sample MCP configs

Safety

  • Listens on loopback only
  • Unknown object_id values are rejected (no host pointer injection)
  • One client connection at a time

Status

Live-validated on Windows + real AviUtl2: create/move/property/media/shape, safety checks, reconnect.
Catalog package id: tranczmeq.aviutl2-mcp-bridge (listing after Catalog registration — see docs/CATALOG.md).

License

MIT — see LICENSE. Third-party SDK headers: plugin/third_party/NOTICE.md.

日本語（概要）

AviUtl2 を起動したまま AI エージェントからタイムラインを操作するためのブリッジです。

  1. プラグイン aviutl2_mcp_bridge.aux2 を AviUtl2 Catalog または手動で Plugin に入れる
  2. AviUtl2 を再起動し、プロジェクトを開く
  3. MCP を pip install -e . などで入れ、aviutl2-live-mcp をエージェントに登録

詳細: docs/ja/README.md