AI导哈

MotionBuilder MCP服务端

为Autodesk MotionBuilder 2026设计的MCP服务端，通过本地TCP实现大语言模型与MotionBuilder的实时交互，支持Python指令执行、场景节点查询与时间轴控制，适用于AI辅助动画制作与场景开发。

  • by AokiYuune
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AokiYuune/motionbuilder-mcp

使用说明

vibe coding

English

A Model Context Protocol (MCP) server for Autodesk MotionBuilder 2026. This project enables LLMs (like Claude) to interact with MotionBuilder via a local TCP loopback, avoiding hardcoded paths and maintaining a clean development environment.

🚀 Key Features

  • Decoupled Architecture: Communicates via localhost TCP; no need to specify the MotionBuilder executable path.
  • Modern Toolchain: Fully compatible with uv and uvx for zero-config execution.
  • Live Interaction: Execute Python commands, query scene nodes, and control the timeline in real-time.

🛠️ Quick Start

1. Start the Listener in MotionBuilder

Run the script located at {Root}/mobu_bridge/bridge.py inside the MotionBuilder Python Editor. This opens a TCP port (default: 7001) to receive commands.

2. Run the MCP Server via uvx

You can run the server directly from the local repository:

# Run from local directory
uvx --from . mobu-mcp

Or run directly from GitHub:

uvx --from git+https://github.com/AokiYuune/motionbuilder-mcp.git mobu-mcp

⚙️ Configuration

Environment variables can be set in a .env file or passed via CLI:

  • MOBU_HOST: Default 127.0.0.1
  • MOBU_PORT: Default 7001

中文

这是一个专为 Autodesk MotionBuilder 2026 设计的模型上下文协议 (MCP) 服务端。本项目通过本地 TCP 回环（Localhost）实现与 MotionBuilder 的通信，无需硬编码软件路径，确保了开发环境的整洁与灵活性。

🚀 核心特性

  • 解耦架构：通过 localhost TCP 通信，无需指定 motionbuilder.exe 的具体位置。
  • 现代工具链：完全兼容 uv 与 uvx，实现零配置运行。
  • 实时交互：支持实时执行 Python 指令、查询场景节点以及控制时间轴。

🛠️ 快速上手

1. 在 MotionBuilder 中启动监听器

将 {Root}/mobu_bridge/bridge.py 中的脚本内容复制到 MotionBuilder 的 Python Editor 中并运行。这将开启一个 TCP 端口（默认：7001）用于接收指令。

2. 通过 uvx 运行 MCP 服务

无需手动安装环境，直接在本地仓库目录下运行：

# 从本地目录运行
uvx --from . mobu-mcp

或者直接从 GitHub 远程运行：

uvx --from git+https://github.com/AokiYuune/motionbuilder-mcp.git mobu-mcp

⚙️ 环境配置

可以通过 .env 文件或命令行设置环境变量：

  • MOBU_HOST: 默认 127.0.0.1
  • MOBU_PORT: 默认 7001

相关 MCP