Tripo AI MCP 服务器

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

功能

• 文本生成 3D: 根据文本提示生成 3D 模型。

• 图像生成 3D: 根据图像生成 3D 模型（支持本地路径、URL 或预上传的令牌）。

• 多视图生成 3D: 根据多视图图像生成 3D 模型（支持本地路径、URL 或令牌）。

• 模型优化: 提高草稿模型的质量。

• 风格化: 为模型应用风格（乐高、体素、泰森多边形、我的世界）。

• 模型纹理化: 为现有模型重新贴图，可选择由文本或图像提示引导。

• 模型转换: 将模型导出为不同格式（GLTF、FBX、OBJ、STL、USDZ、3MF）。

• 动画工作流: 检查绑定可行性 → 绑定模型 → 重定向预设动画。

• 任务状态: 检查任何生成任务的状态并获取输出 URL。

• 上传文件: 上传本地图像文件并获取可重用的文件令牌。

Related MCP server: Tripo3D MCP

安装

npm install -g tripo-ai-mcp-server

配置

你需要一个 Tripo3D API 密钥。你可以在 .env 文件中设置它，或者将其作为环境变量 TRIPO_API_SECRET 传递。

客户端配置

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json 中（通常位于 Windows 上的 %APPDATA%\Claude\claude_desktop_config.json 或 macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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: 为模型应用视觉风格（乐高、体素、泰森多边形、我的世界）。

• 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 Actions 工作流 (.github/workflows/publish.yml) 会在每次创建新的 GitHub Release 时自动将包发布到 npm。

一次性设置：

1. 在 npmjs.com 生成一个 npm Automation 令牌 → 头像 → Access Tokens → Generate New Token → Automation。

2. 将其添加为 GitHub 中的仓库机密：Settings → Secrets and variables → Actions → New repository secret → 命名为 NPM_TOKEN。

发布新版本：

1. 增加 package.json 中的 "version"。

2. 提交并推送。

3. 创建一个新的 GitHub Release（使用版本号标记，例如 v1.1.0）。工作流会自动触发并发布到 npm。

许可证

ISC