RELATED 01
comfyui-mcp
Control a ComfyUI install: build and run workflows, fetch models, manage nodes and VRAM
897GitHub stars
12k/wknpm downloads
78popularity score
Meshy MCP Server
Generate, rig, texture and prepare 3D models for printing through the Meshy AI API
Official · Meshy AI TypeScript Local · stdio AI and MLMedia
75 popularity score ★ 91 ↓ 27k/wk
Connect your client
Local (npm)
Add in one click
Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.
Or add it by command or config
It needs MESHY_API_KEY. Replace each <NAME> with your value.
Claude CodeTerminal
claude mcp add meshy -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @meshy-ai/meshy-mcp-serverClaude Desktopclaude_desktop_config.json
{
"mcpServers": {
"meshy": {
"command": "npx",
"args": [
"-y",
"@meshy-ai/meshy-mcp-server"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}Cursor~/.cursor/mcp.json
{
"mcpServers": {
"meshy": {
"command": "npx",
"args": [
"-y",
"@meshy-ai/meshy-mcp-server"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}VS Code.vscode/mcp.json
{
"servers": {
"meshy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@meshy-ai/meshy-mcp-server"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}Codex~/.codex/config.toml
[mcp_servers.meshy]
command = "npx"
args = ["-y", "@meshy-ai/meshy-mcp-server"]
[mcp_servers.meshy.env]
MESHY_API_KEY = "<MESHY_API_KEY>"Gemini CLITerminal
gemini mcp add --scope user -e MESHY_API_KEY=<MESHY_API_KEY> meshy npx -- -y @meshy-ai/meshy-mcp-serverSettings 5
MESHY_API_KEY |
Required: Meshy API key starting with msy_; every tool returns an error without it. |
|---|---|
MESHY_API_HOST |
Optional: API base URL, https://api.meshy.ai by default. |
TRANSPORT |
Optional: stdio (default) or http. |
PORT |
Optional: Port for HTTP mode, 3000 by default. |
CHARACTER_LIMIT |
Optional: Largest response in characters, 25000 by default. |
What it does
Meshy MCP Server is the Meshy team's own bridge between an MCP client and the Meshy AI 3D generation API. Through 28 tools an assistant can turn a text prompt or one to four photos into a 3D model, refine and retexture it, remesh it, add a skeleton and animations to a humanoid character, convert or resize it, and generate or edit 2D images with several image models. A Creative Lab tool runs a whole photo-to-product pipeline (figures, keychains, lamps, keycaps and similar) and returns only the finished model.
It also covers 3D printing: a free printability check, paid repair, multi-colour 3MF output, splitting a model into printable parts, and a slicer tool that looks for seven installed slicers. That tool does not open the slicer itself; per src/utils/slicer-detector.ts it only checks which programs are installed and hands back a launch command for the client to run.
Almost every call spends Meshy credits (from 1 credit for a conversion to 62 for a keycap product), and generation tasks run asynchronously, so the tools for status, listing, cancelling and downloading tasks matter as much as the generators. Downloaded models are saved under a meshy_output folder in the directory the server was started from (src/services/output-manager.ts), sorted into project folders with metadata.
What it needs
| Runtime | Node.js 18+ |
|---|
Node.js 18 or newer (the launch command uses npx). A Meshy account with an API key starting with msy_; Meshy's README says API keys need the Pro plan or above, and each generation spends credits from that account. Usage reporting needs a Studio or Enterprise team. Opening results in a slicer needs one of the supported slicers installed.
Limits
Every tool except the printability check and list or status calls costs Meshy credits; a refined textured model is 30 to 35 credits. Rigging and animation are for humanoid characters. Some options are deprecated (ultra_mode, hd_texture, meshy-7 and meshy-t1 model ids), meshy-5 is no longer accepted, and model_type lowpoly retires on 2026-10-30. Model choices differ per tool: retexture does not take meshy-7.1, and multi-image generation has no Smart Topology. In HTTP mode (TRANSPORT=http) the /mcp endpoint has no sign-in of its own and Express listens on every interface at PORT, 3000 by default (src/index.ts at v0.6.4). Responses are cut at 25,000 characters unless CHARACTER_LIMIT is raised.
Who it suits
Suits developers, game artists and 3D-printing hobbyists who already pay for Meshy and want an assistant to generate assets, rig characters or prepare prints from a chat. As Meshy's own server it tracks new Meshy models quickly. It is a poor fit without a paid Meshy plan, for anyone who wants local, offline 3D generation (all work runs on Meshy's servers), or for editing existing meshes by hand, which is a job for a desktop 3D tool.
Tools 28
meshy_text_to_3d- Start a text-prompt 3D preview model
meshy_text_to_3d_refine- Add textures to a text-to-3D preview
meshy_image_to_3d- Build a 3D model from one image
meshy_multi_image_to_3d- Build a 3D model from up to four views of one object
meshy_creative_lab- Turn a photo into a finished printable product such as a figure or keychain
meshy_remesh- Rebuild a model's mesh at a new face count or topology
meshy_retexture- Give an existing model new textures from a prompt or reference images
meshy_rig- Add a skeleton to a humanoid model
meshy_animate- Apply preset or generated animations to a rigged model
meshy_text_to_motion- Generate a motion clip from a description
meshy_list_animations- Look up preset animation action ids
meshy_convert- Convert a model to another file format, including 3MF
meshy_resize- Scale a model to real-world dimensions
meshy_uv_unwrap- Produce a clean UV layout for a model
meshy_text_to_image- Generate an image from a prompt with a choice of image models
meshy_image_to_image- Edit or restyle an image, including an earlier result
meshy_get_task_status- Check progress and results of a task
meshy_list_tasks- List tasks by type and status
meshy_cancel_task- Cancel a running task
meshy_download_model- Save a finished model's files to the local output folder
meshy_list_models- List finished 3D models in the workspace
meshy_send_to_slicer- Find installed slicers and return a command to open a model in one
meshy_analyze_printability- Free check of a model for watertightness, holes and wall thickness
meshy_repair_printability- Repair mesh problems and thicken thin walls for printing
meshy_process_multicolor- Make a multi-colour 3MF for AMS or MMU printers
meshy_auto_split- Cut a model into printable parts, with optional connectors
meshy_check_balance- Show the account's remaining credits
meshy_list_usage- List finished tasks with the credits they used