trident-mcp

trident-mcp 是一个用于 AI 辅助 3D 模型生成和后处理的 Go MCP 服务器。

该服务器与客户端无关，可独立与任何兼容 MCP 的客户端配合使用。您无需任何配套技能或其他 MCP 服务器即可使用核心的 3D 生成、轮询、下载和后处理工具。

它目前内置了基于 Tripo 的提供程序，并提供了以下工具：

• 文本转 3D 生成

• 图像转 3D 生成

• 多视图转 3D 生成

• 异步任务轮询

• 模型下载

• 重拓扑

• 格式转换

• 风格化

• 模型目录和服务器配置检查

要求

• Go 1.25+

• TRIPO_API_KEY 中的 Tripo API 密钥

安装

本地构建：

go build ./cmd/trident-mcp

或使用 Go 安装：

go install github.com/mordor-forge/trident-mcp/cmd/trident-mcp@latest

配置

服务器从环境变量读取配置：

运行

服务器通过 stdio 进行 MCP 通信：

TRIPO_API_KEY=tsk_your_key_here trident-mcp

MCP 客户端配置示例：

{
  "mcpServers": {
    "trident-mcp": {
      "command": "trident-mcp",
      "env": {
        "TRIPO_API_KEY": "tsk_your_key_here",
        "MODEL_OUTPUT_DIR": "/absolute/path/to/generated_models"
      }
    }
  }
}

工具

生成

• text_to_3d

• image_to_3d

• multiview_to_3d

这些工具启动异步任务。使用 task_status 轮询完成情况，然后使用 download_model 获取任务输出。

状态与下载

• task_status

• download_model

download_model 会保存任务的实际输出格式。如果您需要其他格式，请先运行 convert_format，然后再下载转换后的任务。

后处理

• retopologize

• convert_format

• stylize

内省

• list_models

• get_config

get_config 会报告当前活动的后端、输出目录和服务器版本。

技能

该仓库还在 skills/ 下包含了配套的代理技能：

• skills/3d-gen/SKILL.md

• skills/multiview-3d/SKILL.md

• skills/3d-to-blender/SKILL.md

这些技能是可选的。MCP 服务器本身可以在任何 MCP 客户端中独立运行。

部分配套技能旨在将 trident-mcp 与 gemini-media-mcp 组合使用，以实现更完整的自动化流水线。在这种设置中，gemini-media-mcp 可以辅助构思、参考图像生成和多角度图像创建，而 trident-mcp 则负责重建和后处理。这种组合实现了从创意到成品 3D 模型更完整的流程。

开发

运行本地检查：

go test ./...
go vet ./...

此外还有一个可选的端到端（E2E）冒烟测试，用于实时 Tripo 上传：

TRIPO_API_KEY=tsk_your_key_here go test -tags=e2e -run "TestE2E_" ./internal/provider/tripo/ -v

发布

GitHub Actions 会在推送和拉取请求时运行单元检查，并在 main 分支和版本标签上运行 E2E 冒烟测试。带标签的发布版本由 GoReleaser 构建。

构建产物会标记发布版本，以确保二进制文件和 MCP 实现元数据保持一致。