Tripo CN MCP Server

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

git clone https://github.com/<your-username>/tripo-cn-mcp.git
cd tripo-cn-mcp

uv sync --dev

copy .env.example .env

TRIPO_CN_API_KEY=你的_Tripo_中国站_API_Key

uv run tripo-cn-mcp

[mcp_servers.tripo_cn]
command = 'C:\Users\<用户名>\AppData\Roaming\Python\Python314\Scripts\uv.exe'
args = [
  "run",
  "--project",
  "D:\projects\tripo-cn-mcp",
  "tripo-cn-mcp"
]
startup_timeout_sec = 30
tool_timeout_sec = 900
enabled = true

[mcp_servers.tripo_cn.env]
TRIPO_CN_API_KEY = '你的_API_Key'
TRIPO_CN_OUTPUT_DIR = 'D:\ExternalGenerated\TripoCN'
TRIPO_CN_LOG_LEVEL = 'INFO'

# 1. 提交生成任务
task = await tripo_cn_create_text_to_model_task(
    prompt="a cute cat wearing a spacesuit",
    model="v3.1-20260211",
    texture=True,
    pbr=True
)
# → {"success": true, "task_id": "task_abc123"}

# 2. 等待完成
result = await tripo_cn_wait_for_task(task_id="task_abc123")
# → {"success": true, "status": "success", "model_url": "https://..."}

# 3. 下载结果
download = await tripo_cn_download_from_task(task_id="task_abc123")
# → {"success": true, "absolute_path": "C:/.../model_abc.glb"}

# 1. 图片生成模型
img_task = await tripo_cn_create_image_to_model_task(
    input="https://example.com/char.png",
    model="P1-20260311"
)

# 2. 检查可绑定性
rig_check = await tripo_cn_create_rig_check_task(
    input_task_id=img_task.task_id
)
# → riggable: true

# 3. 绑定骨骼
rig_task = await tripo_cn_create_rig_task(
    input_task_id=img_task.task_id,
    rig_type="biped"
)

# 4. 应用动画
anim_task = await tripo_cn_create_retarget_task(
    input_task_id=rig_task.task_id,
    animation="preset:walk"
)

batch = await tripo_cn_batch_get_tasks(
    task_ids=["task_abc123", "task_def456"]
)
# → {"success": true, "tasks": {...}, "missed": []}

美术 Agent                           Unity 开发 Agent
─────────                           ────────────────
tripo-cn-mcp                        Unity MCP
  │ 生成 3D 模型                      │ 导入模型
  ▼                                  ▼
ExternalGenerated/TripoCN  ────►  Assets/ArtGenerated/Staging
  (暂存目录)     人工/自动审核         (临时资源 → 正式 Prefab)

tripo-cn-mcp/
├── pyproject.toml             # 项目配置与依赖声明
├── uv.lock                    # 依赖版本锁定
├── README.md
├── .env.example               # 环境变量模板
├── .gitignore
├── docs/                      # 官方 API 文档（30 份 PDF）+ 架构/安全说明
│   ├── architecture.md
│   ├── security.md
│   ├── api-gap-analysis.md
│   └── codex-config.md
├── src/tripo_cn_mcp/
│   ├── __main__.py            # 入口点
│   ├── server.py              # FastMCP STDIO Server（25 个工具注册）
│   ├── settings.py            # pydantic-settings 配置管理
│   ├── client.py              # httpx AsyncClient 封装（含错误码映射）
│   ├── errors.py              # 13 个自定义异常类
│   ├── models/                # Pydantic 数据模型
│   ├── services/              # 业务逻辑（轮询、下载、路径安全）
│   └── tools/                 # MCP 工具实现（按领域拆分）
└── tests/                     # 84 个测试（全部 Mock，零额度消耗）
    └── fixtures/              # JSON 测试夹具

# 运行全部测试
uv run pytest

# 代码检查
uv run ruff check .
uv run ruff format --check .
uv run pyright

~/ExternalGenerated/TripoCN/
├── model_abc.glb              # 生成结果
├── model_abc_1.glb            # 同名自动编号
└── tripo_download_*.tmp       # 下载临时文件（自动清理）

# 检查依赖
uv sync --dev

# 验证配置（不显示完整 API Key）
uv run python -c "from tripo_cn_mcp.settings import Settings; s=Settings(); print('OK:', s.masked_dict())"