Meshy 3D — Claude Code plugin

Generate 3D models, textures, rigs, animations, and 3D-print files from any Claude Code session via the Meshy AI API.

Install

Get an API key at meshy.ai/settings/api and export it (shell profile):
```
export MESHY_API_KEY=msy_...
```
Add the marketplace and install (restart Claude Code first if you just set the env var):
```
/plugin marketplace add shoyu-ramen/meshy-claude-plugin
/plugin install meshy@meshy-marketplace
```
From a local clone instead: /plugin marketplace add /path/to/meshy-claude-plugin

What you get

18 MCP tools (mcp__plugin_meshy_meshy__*):

Group	Tools
Generate 3D	`text_to_3d` (preview→refine), `image_to_3d`, `multi_image_to_3d`
Process	`process_model` (remesh/convert/resize/uv_unwrap), `retexture`
Characters	`rig`, `animate`, `search_animations` (~680-action catalog)
Images	`text_to_image`, `image_to_image`
3D printing	`printing` (analyze/repair/multi_color)
Creative Lab	`creative_lab` (keychain, fridge-magnet, figure, vinyl-figure, brick-figure, lamp, keycap)
Tasks	`get_task`, `list_tasks`, `delete_task`, `wait_for_task`
Utility	`download_assets`, `get_balance`

Slash commands: /meshy:generate "<prompt>" (full pipeline incl. download), /meshy:balance.

Skill: workflow guidance (two-stage text-to-3D, character rig+animate pipeline, credit costs, 3-day URL expiry) loads automatically when relevant.

Usage notes

All generations are async tasks: create → wait_for_task → download_assets. Output URLs expire ~3 days after completion — download promptly.
analyze-printability and search_animations are free; get_balance shows remaining credits.
Task summaries omit signed URLs to keep agent context small; raw: true returns full objects.

Development

npm install
npm run build       # bundle src/ → dist/index.mjs (committed — plugins run no install step)
npm run typecheck
npm test
node scripts/stdio-check.mjs                 # handshake + tools/list
node scripts/stdio-check.mjs --call get_balance '{}'
npm run inspect     # MCP inspector UI

src/registry.ts maps every task_type to its API path — generic task tools and download_assets work across all 29 task types from that single table.

Meshy 3D — Claude Code plugin