pasie15/meshy-ai-mcp-server
If you are the rightful owner of meshy-ai-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
Meshy AI MCP Server is a Model Context Protocol server designed to interact with the Meshy AI API, enabling the generation and manipulation of 3D models from text and images.
Meshy AI MCP Server
This is a Model Context Protocol (MCP) server that wraps the Meshy AI API. It enables MCP clients (like Claude Desktop, Cursor, Cline) to interact with Meshy's generative 3D tools directly.
Features
- Text-to-3D: Generate 3D models from text prompts.
- Image-to-3D: Create 3D models from reference images.
- Text-to-Texture: Apply textures to existing models using text prompts.
- Model Optimization: Remesh and optimize geometry.
- Rigging: Auto-rig 3D characters for animation.
- Animation: Apply animations to rigged characters.
- Streaming: Real-time progress updates for long-running tasks.
Installation
Option 1: Run directly with npx (Recommended)
You can run the server directly using npx without installing it globally.
{
"mcpServers": {
"meshy-ai": {
"command": "npx",
"args": [
"-y",
"meshy-ai-mcp-server"
],
"env": {
"MESHY_API_KEY": "your_meshy_api_key_here"
}
}
}
}
Option 2: Clone and Build Locally
If you want to modify the code or run it from a local source:
-
Clone the repository:
git clone <repository-url> cd meshy-ai-mcp-server -
Install dependencies:
npm install -
Build the project:
npm run build -
Configure your MCP Client:
Add the following to your MCP client configuration (e.g.,
claude_desktop_config.jsonor VS Code settings):{ "mcpServers": { "meshy-ai": { "command": "node", "args": [ "/absolute/path/to/meshy-ai-mcp-server/dist/index.js" ], "env": { "MESHY_API_KEY": "your_meshy_api_key_here" } } } }
Configuration
You need a Meshy AI API key to use this server.
- Get your API key from the Meshy Dashboard.
- Set the
MESHY_API_KEYenvironment variable in your MCP client configuration (as shown above).
Optional Environment Variables
MESHY_API_BASE: Override the API base URL (default:https://api.meshy.ai/openapi).MESHY_STREAM_TIMEOUT_MS: Timeout for streaming responses in milliseconds (default:300000aka 5 minutes).
Development
To run the server in development mode with auto-reloading:
# Create a .env file
echo "MESHY_API_KEY=your_key_here" > .env
# Run in dev mode
npm run dev
Available Tools
- Text to 3D:
create_text_to_3d_task,retrieve_text_to_3d_task,list_text_to_3d_tasks,stream_text_to_3d_task - Image to 3D:
create_image_to_3d_task,retrieve_image_to_3d_task,list_image_to_3d_tasks,stream_image_to_3d_task - Texturing:
create_text_to_texture_task,retrieve_text_to_texture_task,list_text_to_texture_tasks,stream_text_to_texture_task - Remeshing:
create_remesh_task,retrieve_remesh_task,list_remesh_tasks,stream_remesh_task - Rigging:
create_rigging_task,retrieve_rigging_task,list_rigging_tasks,stream_rigging_task - Animation:
create_animation_task,retrieve_animation_task,list_animation_tasks,stream_animation_task - Utility:
get_balance
License
MIT
