内容
# motion-previs-mcp
MCP（模型上下文协议）stdio 桥接器，用于 **[Motion Previs Studio](https://github.com/wassermanproductions/motion-previs-studio)** — 开源桌面应用程序，可将真实参考视频转换为 AI 生成器控制包。连接此服务器后，AI 代理可以导入镜头（本地文件或 URL）、修剪范围、选择要保留的内容（相机移动、演员表现、物体运动或整个场景）、运行分析管道、监视进度、导出包（深度通道、OpenPose 骨架视频 + 关键点、相机路径、提示），并将图层直接发送到 [Blockout](https://github.com/wassermanproductions/blockout) 预视应用程序。
零依赖。Node ≥ 18。一个文件。
## 要求
1. **Motion Previs Studio v4.1+ 必须正在运行。** 从 [应用程序仓库](https://github.com/wassermanproductions/motion-previs-studio) 获取（从源代码构建或使用发布 DMG）。
2. 启动时，应用程序会在一个随机端口上启动一个 **仅限本地主机** 的控制服务器，并将一个发现文件写入 `~/.config/motion-previs/control.json`（随机 bearer token，模式 0600，退出时删除）。此桥接器会自动读取该文件 — 无需配置，无需输入凭证。
## 连接
### Hermes
添加到 `~/.hermes/config.yaml`（或从 Hermes MCP 目录中安装，一旦列出）：
```yaml
mcp_servers:
motion-previs:
command: "node"
args: ["/absolute/path/to/motion-previs-mcp/motion-previs-mcp.mjs"]
```
### Claude 代码
```bash
claude mcp add motion-previs -- node /absolute/path/to/motion-previs-mcp/motion-previs-mcp.mjs
```
### 任意 MCP 客户端（通用_stdio 配置）
```json
{ "mcpServers": { "motion-previs": { "command": "node", "args": ["/absolute/path/to/motion-previs-mcp/motion-previs-mcp.mjs"] } } }
```
## 工具（11）
`get_state` · `import_file` · `import_url` · `set_range` · `set_mode` · `set_settings` · `run_analysis` · `export_pack` · `list_bundle` · `send_to_blockout` · `screenshot`
代理工作流：`import_file`/`import_url` → `set_range` + `set_mode`（camera_only | actor_motion | object_motion | full_scene）→ `run_analysis` → 轮询 `get_state` 直到 `analysis.status` 为 `done` → `export_pack` → 可选 `send_to_blockout`（参考 / 深度 / ai_depth / 姿势 / openpose）。
## 安全
应用程序的控制服务器仅绑定到 127.0.0.1，使用每个启动的随机 bearer token，并验证每个操作是否与白名单匹配。没有任何内容暴露在机器之外。
## 许可证和致谢
Apache-2.0 — 见 [LICENSE](LICENSE)。根据 [NOTICE](NOTICE) 文件，使用、分支和重新分发必须注明 **Sam Wasserman ([wassermanproductions.com](https://wassermanproductions.com))**。
