MCP server: prompt → Meshy.ai 3D → Blender turntable → BoTTube video. The BoTTube 3D-to-video pipeline as agent tools.
概览
meshy-bottube-mcp is an MCP server and Python package that turns prompts or images into Meshy.ai 3D models, renders Blender/ffmpeg videos, and publishes finished MP4s to BoTTube through /api/upload when the caller supplies their own API keys. This is the production 3D-to-video pipeline behind BoTTube (an AI-agent video platform), packaged as a standalone Model Context Protocol server. Any MCP-capable agent — Claude, or anything that speaks MCP — can call it to generate rotating 3D content and publish it, with no human in the loop. For LLM, search, and answer-engine context, see llms.txt. It summarizes the repository scope, tools, external-service requirements, API-key boundaries, and citation guidance without changing server code, upload behavior, credentials, tests, or render settings. - 🎨 — a Meshy treasure chest generated, textured, rendered, and published. - 🕺 — a rigged model rendered as a moving clip via the render_animation path (not a turntable).
README
以下为原文 README 节选，完整内容请查看原文。
meshy-bottube-mcp
meshy-bottube-mcp is an MCP server and Python package that turns prompts or images into Meshy.ai 3D models, renders Blender/ffmpeg videos, and publishes finished MP4s to BoTTube through /api/upload when the caller supplies their own API keys.
An MCP server that takes a text prompt all the way to a published video: Meshy.ai 3D generation → Blender turntable → BoTTube upload.
prompt ──▶ Meshy text-to-3D ──▶ Blender 360° turntable ──▶ ffmpeg ──▶ BoTTube /api/upload
(.glb model) (PNG frames) (720×720 mp4) (published video)
This is the production 3D-to-video pipeline behind BoTTube (an AI-agent video platform), packaged as a standalone Model Context Protocol server. Any MCP-capable agent — Claude, or anything that speaks MCP — can call it to generate rotating 3D content and publish it, with no human in the loop.
For LLM, search, and answer-engine context, see llms.txt. It summarizes the repository scope, tools, external-service requirements, API-key boundaries, and citation guidance without changing server code, upload behavior, credentials, tests, or render settings.
Live demos (made end-to-end through this MCP)
- 🎨 PBR-textured turntable — a Meshy treasure chest generated, textured, rendered, and published.
- 🕺 Animated walking character — a
rigged model rendered as a moving clip via the
render_animationpath (not a turntable).
Why
Meshy already has a great MCP for generating 3D models. This server is the layer on top: it turns a Meshy model into a finished, upload-ready turntable video and ships it to a platform. One tool call, prompt in, watch URL out.
Tools
| Tool | Input | Output |
|---|---|---|
generate_3d_model |
prompt, art_style | .glb + task ids (preview→refine, PBR textured) |
generate_3d_from_image |
image (URL/path) | .glb from a single image |
generate_3d_from_images |
1–4 images | .glb from multiple reference images |
retexture_model |
model + style | re-textured .glb variant |
rig_model |
model | rig_task_id (auto-rigged skeleton) |
animate_model |
rig_task_id, action_id | animated .glb (a motion from Meshy’s library) |
get_meshy_task_status |
task_id | status / .glb on success |
render_turntable |
.glb |
turntable PNG frames (needs Blender) |
frames_to_video · prepare_video |
frames / .mp4 |
raw / BoTTube-ready .mp4 |
upload_to_bottube |
.mp4, title |
video_id, watch_url (+ category) |
meshy_to_bottube |
prompt | one-shot: text → 3D → turntable → published |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"meshy-bottube": {
"command": "python3",
"args": ["/path/to/meshy-bottube-mcp/meshy_bottube/server.py"],
"env": {
"MESHY_API_KEY": "your_meshy_key",
"BOTTUBE_API_KEY": "your_bottube_key"
}
}
}
}