3D模型生成服务器

Tripo AI MCP Server是一个用于Tripo3D AI API的模型上下文协议服务器,允许AI助手与Tripo的3D生成功能进行交互。

  • by pasie15
  • JavaScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 pasie15/tripo-ai-mcp-server

使用说明

Tripo AI MCP服务器

这是一个模型上下文协议(MCP)服务器,用于 Tripo3D人工智能 API它允许AI助手与Tripo的3D生成功能进行交互。

特性

  • 文本转换为3D:根据文本提示生成3D模型。
  • 图像到3D:从图像生成3D模型(支持本地路径、URL或预上传的令牌)。
  • 多视图到3D:从多个视图图像(本地路径、URL或令牌)生成3D模型。
  • 优化模型:提高模型草稿的质量。
  • 风格化:将样式(乐高、体素、沃罗诺伊、minecraft)应用于模型。
  • 纹理模型:重新为现有模型设置纹理,可选择由文本或图像提示引导。
  • 转换模型:将模型导出为其他格式(GLTF、FBX、OBJ、STL、USDZ、3MF)。
  • 动画工作流程:检查刚性→ 装配模型→ 重新定位预设动画。
  • 任务状态:检查状态并检索任何生成任务的输出URL。
  • 上传文件:上传本地映像文件并接收可重用的文件令牌。

安装

npm install -g tripo-ai-mcp-server

配置

您需要一个Tripo3 D API机密。您可以将其设置为 .env 将其作为环境变量进行归档或传递 TRIPO_API_SECRET.

客户端配置

克劳德桌面

将以下内容添加到您的 claude_desktop_config.json (通常在 %APPDATA%\Claude\claude_desktop_config.json 在Windows或 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "tripo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "tripo-ai-mcp-server"
      ],
      "env": {
        "TRIPO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

用法

启动服务器:

tripo-ai-mcp-server

工具

  • text_to_3d:根据文本描述生成3D模型。
  • image_to_3d:从图像(本地路径、URL或预上传的令牌)生成3D模型。
  • multiview_to_3d:从多个视图图像生成3D模型。
  • get_task_status:检查任务状态并检索输出模型URL。
  • upload_file:上传本地映像文件并接收可重用的文件令牌。
  • refine_model:完善模型草案以提高质量。
  • animate_prerigcheck:检查模型是否适合装配。
  • rig_model:装配模型,使其可以设置动画。
  • retarget_animation:将预设动画应用于装配模型。
  • stylize_model:将视觉样式应用于模型(乐高、体素、沃罗诺伊、minecraft)。
  • convert_model:将模型转换为不同的文件格式(GLTF、FBX、OBJ、STL、USDZ、3MF)。
  • texture_model:为现有模型生成新纹理。

发展

  1. 克隆仓库。
  2. npm install
  3. npm run build
  4. node dist/index.js

发布到npm

GitHub操作工作流(.github/workflows/publish.yml)每当创建新的GitHub Release时,都会自动将包发布到npm。

一次性设置:

  1. 生成一个npm 自动化 令牌在 npmjs.com → 阿凡达→ 访问令牌→ 生成新令牌→ 自动化。
  2. 将其添加为GitHub中的存储库机密:设置→ 秘密与变量→ 行动→ 新存储库机密→ 命名它 NPM_TOKEN.

要发布新版本,请执行以下操作:

  1. 碰撞 "version" 在 package.json.
  2. 承诺并推动。
  3. 创建一个新的GitHub版本(用版本标记它,例如。 v1.1.0).工作流会自动触发并发布到npm。

许可证

国际学生委员会