Moho MCP

MohoMCP

MCP（模型上下文协议）服务器 莫霍Pro 14 --使Claude Desktop和Claude Code等人工智能助手能够阅读、编写、动画和视觉操作MOHO动画项目。

完全跨平台：Windows和macOS。

建筑

┌─────────────────────┐    File-based IPC     ┌──────────────────────┐
│  MCP Bridge Server  │◄──────────────────►   │  Moho Lua Plugin     │
│  (TypeScript/Node)  │  $TMPDIR/moho-mcp/    │  (runs inside MOHO)  │
└────────┬────────────┘   JSON-RPC 2.0        └──────────────────────┘
         │ MCP Protocol (stdio)
┌────────▼────────────┐
│  MCP Client/Host    │
│  (Claude Desktop,   │
│   Claude Code, etc) │
└─────────────────────┘

三个组成部分：

1. Moho Lua插件 -基于文件的IPC服务器运行在MOHO内部，通过MOHO的Lua 5.4 API处理读/写操作
2. MCP网桥服务器 --Node.js进程将MCP协议（stdio）桥接到基于文件的JSON-RPC
3. 静态知识资源 --Moho手册中的键盘快捷键和工具参考数据

能力

可用工具（26）

只读工具

写入工具

视觉和输入工具

批量执行

性能提示： 总是喜欢 batch_execute 当你需要2+次手术时。一批10个操作与一个单独的调用所需的时间相同。

知识资源

快速开始

1.安装MOHO插件

复制 moho-plugin/ 将内容放入MOHO的scripts文件夹，或使用提供的安装脚本：

窗户： 跑 install-plugin.bat （或手动复制到 C:\Program Files\Moho 14\Resources\Support\Scripts\Menu\)

macOS： 跑 chmod +x install-plugin.sh && ./install-plugin.sh （或手动复制到 /Applications/Moho 14/Moho Pro.app/Contents/Resources/Support/Scripts/Menu/)

要复制的文件：

• MohoMCP_Server.lua
• MohoMCP_Poller.lua
• json.lua
• moho_mcp/ （整个目录）

2.构建网桥服务器

cd bridge
npm install
npm run build

3.开始一切

1. 打开 莫霍Pro 14 并加载项目
2. 首选 脚本>MohoMCP服务器 启动IPC服务器
3. 启动MCP客户端（Claude Desktop或Claude Code）——网桥自动连接

4.配置克劳德桌面

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "moho-mcp": {
      "command": "node",
      "args": ["C:/path/to/MohoMCP/bridge/dist/index.js"]
    }
  }
}

5.配置克劳德代码

地点a .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "moho-mcp": {
      "command": "node",
      "args": ["C:/path/to/MohoMCP/bridge/dist/index.js"]
    }
  }
}

配置

环境变量：

内部计时（in bridge/src/config.ts):

运作原理

基于文件的IPC

通信使用系统临时目录中的JSON文件(%TEMP%\moho-mcp\ 在Windows上， $TMPDIR/moho-mcp/ 在macOS上）：

1. 布里奇写道 req_.json （JSON-RPC 2.0请求）
2. MOHO Lua插件通过DrawMe/IsEnabled回调轮询请求文件
3. Lua处理请求，写入 resp_.json
4. Bridge读取响应，清理文件

保持活力机制

MOHO只在UI重新绘制期间处理Lua回调。后台进程会定期强制重新绘制视口（~4 Hz），以保持轮询循环的活动状态，即使用户没有交互：

• 窗户： PowerShell进程调用Win32 RedrawWindow()
• macOS： AppleScript进程推动Moho应用程序

安全

• 允许列表验证：只能调用显式注册的方法
• 参数验证：执行前检查所有参数类型
• pcall包装：所有Lua处理程序都封装在受保护的调用中——一个方法中的崩溃不会导致服务器崩溃

发展

cd bridge
npm install
npm run dev      # Watch mode — recompiles on changes
npm test         # Run test suite (61 tests)
npm run test:watch

项目结构

MohoMCP/
├── bridge/                    # TypeScript MCP Bridge Server
│   └── src/
│       ├── index.ts           # Entry point & bootstrap
│       ├── config.ts          # IPC directory, timeouts
│       ├── moho-client.ts     # File-based IPC client
│       ├── protocol.ts        # JSON-RPC 2.0 types
│       ├── tools.ts           # 26 MCP tool registrations
│       ├── resources.ts       # Static knowledge resources
│       ├── keep-alive.ts      # Cross-platform viewport refresh
│       ├── platform-capture.ts # Platform dispatch → window capture
│       ├── platform-input.ts  # Platform dispatch → input simulation
│       ├── window-capture.ts  # Win32 screenshot capture
│       ├── darwin-capture.ts  # macOS screenshot capture
│       ├── win32-input.ts     # Win32 mouse & keyboard
│       ├── darwin-input.ts    # macOS mouse & keyboard
│       └── __tests__/         # Vitest test suite
│
├── moho-plugin/               # Lua Plugin for MOHO 14
│   ├── MohoMCP_Server.lua     # Menu script & DrawMe hooks
│   ├── MohoMCP_Poller.lua     # Polling utilities
│   ├── json.lua               # JSON library
│   └── moho_mcp/
│       ├── server.lua         # File-based IPC server
│       ├── protocol.lua       # JSON-RPC 2.0 protocol
│       ├── validator.lua      # Method allow-list & validation
│       └── tools/             # Handler implementations
│           ├── document.lua
│           ├── layer.lua
│           ├── bone.lua
│           ├── animation.lua
│           ├── mesh.lua
│           └── batch.lua
│
├── docs/                      # Documentation
│   ├── installation.md
│   └── tool-reference.md
│
└── schema/
    └── tools.json             # JSON Schema definitions

平台支持

所有26个工具在两个平台上的工作方式相同。网桥在运行时自动检测操作系统并加载相应的本机后端，无需配置。

Windows要求

• Windows 10/11
• 莫霍Pro 14
• Node.js >= 18.0.0

macOS要求

• macOS （在Ventura+上测试）
• 莫霍Pro 14
• Node.js >= 18.0.0
• 可访问权限 --输入模拟所需（系统设置>隐私和安全>辅助功能>添加您的终端/Claude桌面）
• 点击 （可选，推荐）-- brew install cliclick --提供更可靠的鼠标输入。没有它，就通过JXA回到CoreGraphics。

许可证

麻省理工学院——见 许可证 了解详情。