mcpField
M
mcp-server-3daistudio

mcp-server-3daistudio

本地服务
github.com/whale-professor媒体与设计327 周前更新
代码仓库

关于 mcp-server-3daistudio

mcp-server-3daistudio 是通过 3D AI Studio API 将文本提示词或图像转换为 3D 模型的 Python 技能和 MCP 服务。它支持仅接收图像的 TRELLIS.2，以及可接收文本或图像的 Hunyuan Rapid 和 Pro。

主要功能

  1. 01从图像生成 3D 模型
  2. 02从文本提示词生成 3D 模型
  3. 03使用 TRELLIS.2 和 Hunyuan 模型
  4. 04查询 API 额度余额
  5. 05将生成的模型保存为 GLB

适用场景

  1. 01将照片转换为 3D 模型
  2. 02根据文本描述创建模型
  3. 03生成前检查 API 余额

MCP 相关

项目包含可用于 Claude Desktop 或 Claude Code 的 MCP 服务，通过 MCP 提供 3D AI Studio 的模型生成功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "whale-professor-mcp-server-3daistudio": {
      "command": "uvx",
      "args": [
        "mcp-server-3daistudio"
      ],
      "env": {
        "THREE_D_AI_STUDIO_API_KEY": "<THREE_D_AI_STUDIO_API_KEY>"
      }
    }
  }
}
启动命令uvx mcp-server-3daistudio
需要配置的环境变量
THREE_D_AI_STUDIO_API_KEY密钥API key for 3D AI Studio

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-server-3daistudio1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

3D AI Studio 技能

使用 3D AI Studio API 将图像和文本提示词转换为 3D 模型的技能。

所有者

Whale Professor（Telegram 上的 @WhaleProfessor）

设置

  1. 从 https://www.3daistudio.com/Platform/API 获取 API 密钥
  2. 设置环境变量： 
    export THREE_D_AI_STUDIO_API_KEY="your-api-key"
    或将 .env.example 复制为 .env 并填写密钥。
  3. 运行此技能： 
    python 3daistudio.py balance

支持的模型

模型输入速度点数
TRELLIS.2仅图像25s–4min15–55
Hunyuan Rapid文本或图像2–3min35–55
Hunyuan Pro文本或图像3–6min60–100

快速开始

# 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 服务

此项目还附带 MCP 服务，可与 Claude Desktop 或 Claude Code 搭配使用。有关可安装的软件包，请参阅 mcp-server-3daistudio/，也可以直接将 mcp_server.py 用作独立服务。

文档

  • GUIDE.md — 完整使用指南，包含所有选项和示例
  • SKILL.md — 技能元数据和快速参考
  • CLAUDE.md — 面向 AI Agent 的说明

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。