io.github.whale-professor/mcp-server-3daistudio
MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
mcp-server-3daistudioclaude mcp add mcp-server-3daistudio -e 'THREE_D_AI_STUDIO_API_KEY=<your three_d_ai_studio_api_key>' -- uvx mcp-server-3daistudio==1.0.1
{
"mcpServers": {
"mcp-server-3daistudio": {
"command": "uvx",
"args": [
"mcp-server-3daistudio==1.0.1"
],
"env": {
"THREE_D_AI_STUDIO_API_KEY": "<your three_d_ai_studio_api_key>"
}
}
}
}
متغيرات البيئة
THREE_D_AI_STUDIO_API_KEYإلزامي سري API key for 3D AI Studio
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
3D AI Studio Skill
A skill for converting images and text prompts to 3D models using the 3D AI Studio API.
Owner
Whale Professor (@WhaleProfessor on Telegram)
Setup
- Get an API key from https://www.3daistudio.com/Platform/API
Set the environment variable:
export THREE_D_AI_STUDIO_API_KEY="your-api-key"Or copy
.env.exampleto.envand fill in your key.- Run the skill:
python 3daistudio.py balance
Supported Models
| Model | Input | Speed | Credits |
|---|---|---|---|
| TRELLIS.2 | Image only | 25s–4min | 15–55 |
| Hunyuan Rapid | Text or image | 2–3min | 35–55 |
| Hunyuan Pro | Text or image | 3–6min | 60–100 |
Quick Start
# Check balance
python 3daistudio.py balance
# Image to 3D with TRELLIS.2
python 3daistudio.py trellis --image photo.png -o model.glb
# Text to 3D with Hunyuan Rapid
python 3daistudio.py rapid --prompt "a wooden chair" -o chair.glb
# Text to 3D with Hunyuan Pro (best quality)
python 3daistudio.py pro --prompt "a cute blue hedgehog" -o hedgehog.glb
MCP Server
An MCP server is also included for use with Claude Desktop or Claude Code. See mcp-server-3daistudio/ for the installable package, or use mcp_server.py directly as a standalone server.
Documentation
- GUIDE.md — Full usage guide with all options and examples
- SKILL.md — Skill metadata and quick reference
- CLAUDE.md — Instructions for AI agents
License
MIT
الأسئلة الشائعة
ما هو io.github.whale-professor/mcp-server-3daistudio؟
MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS
كيف أثبّت io.github.whale-professor/mcp-server-3daistudio؟
يعمل على جهازك. في Claude Code: claude mcp add mcp-server-3daistudio -e 'THREE_D_AI_STUDIO_API_KEY=<your three_d_ai_studio_api_key>' -- uvx mcp-server-3daistudio==1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.whale-professor/mcp-server-3daistudio إلى مفتاح API؟
نعم. يتطلب THREE_D_AI_STUDIO_API_KEY، وتضبطها في إعداداته.
هل io.github.whale-professor/mcp-server-3daistudio مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.whale-professor/mcp-server-3daistudio؟
ينشره whale-professor. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.