kveto/mohomcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP bridge server for Moho 14 animation software - control Moho via AI agents
개요
An MCP (Model Context Protocol) server for — enabling AI assistants like Claude Desktop and Claude Code to read, write, animate, and visually operate MOHO animation projects. 1. — File-based IPC server running inside MOHO, handles read/write operations via MOHO's Lua 5.4 API 2. — Node.js process bridging MCP protocol (stdio) to file-based JSON-RPC 3. — Keyboard shortcuts and tool reference data from the Moho manual Always prefer batch_execute when you need 2+ operations. A batch of 10 operations takes the same time as 1 individual call. Copy the moho-plugin/ contents into MOHO's scripts folder, or use the provided install scripts: Run install-plugin.bat (or copy manually to C:\Program Files\Moho 14\Resources\Support\Scripts\Menu) Run chmod +x install-plugin.sh && ./install-plugin.sh (or copy manually to /Applications/Moho 14/Moho Pro.app/Contents/Resources/Support/Scripts/Menu/) Files to copy: - MohoMCP_Server.lua - MohoMCP_Poller.lua - json.
README
원문 README의 일부입니다. 원문 보기.
MohoMCP
An MCP (Model Context Protocol) server for Moho Pro 14 — enabling AI assistants like Claude Desktop and Claude Code to read, write, animate, and visually operate MOHO animation projects.
Fully cross-platform: Windows and macOS.
Architecture
┌─────────────────────┐ 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) │
└─────────────────────┘
Three components:
- Moho Lua Plugin — File-based IPC server running inside MOHO, handles read/write operations via MOHO’s Lua 5.4 API
- MCP Bridge Server — Node.js process bridging MCP protocol (stdio) to file-based JSON-RPC
- Static Knowledge Resources — Keyboard shortcuts and tool reference data from the Moho manual
Capabilities
| Capability | Description |
|---|---|
| Read | Query document structure, layers, bones, animation keyframes, mesh data |
| Write | Set bone/layer transforms, create/delete keyframes, change interpolation, rename layers |
| See | Capture rendered scene frames or full MOHO UI screenshots |
| Interact | Send mouse clicks, drags, and keyboard shortcuts to the MOHO window |
| Know | Built-in reference data for all Moho 14 tools and keyboard shortcuts |
Available Tools (26)
Read-Only Tools
| Tool | Description |
|---|---|
document_getInfo |
Document metadata (name, path, dimensions, FPS, frame range) |
document_getLayers |
Full layer tree with hierarchy |
layer_getProperties |
Detailed layer properties (type, visibility, transform) |
layer_getChildren |
Direct children of a group layer |
layer_getBones |
List bones in a bone layer |
bone_getProperties |
Bone details (position, angle, scale, parent) |
animation_getKeyframes |
Keyframes for a channel on a layer |
animation_getFrameState |
Full layer state at a specific frame |
mesh_getPoints |
Point positions in a vector layer |
mesh_getShapes |
Shape data (fill, stroke, curves) |
Write Tools
| Tool | Description |
|---|---|
bone_setTransform |
Set bone angle/position/scale at a frame (creates keyframes) |
bone_selectBone |
Select a bone in the MOHO UI |
animation_setKeyframe |
Set keyframe value (scalar or vec2) on any channel |
animation_deleteKeyframe |
Remove a keyframe at a specific frame |
animation_setInterpolation |
Set easing mode (linear, smooth, ease_in, ease_out, step) |
document_setFrame |
Navigate to a specific frame on the timeline |
layer_setTransform |
Set layer translation/rotation/scale at a frame |
layer_setVisibility |
Show or hide a layer |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"moho-mcp": {
"command": "node",
"args": ["C:/path/to/MohoMCP/bridge/dist/index.js"]
}
}
}