Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 5 additions & 12 deletions marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -1097,12 +1097,12 @@
"en": "Tripo 3D",
"zh-CN": "Tripo 3D"
},
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts.",
"description_i18n": {
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"zh-CN": "用文字或图片生成带贴图的 3D 模型,添加骨骼与动画、精简模型面数,导出用于游戏或 3D 打印的素材。需使用 Tripo 国内站账号。"
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts.",
"zh-CN": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts."
},
"version": "0.1.4",
"version": "0.1.5",
"author": {
"name": "VAST",
"url": "https://www.tripo3d.ai"
Expand All @@ -1125,14 +1125,7 @@
"Generate a low-poly treasure chest and export it as FBX for Unity",
"Turn this concept image into a textured 3D model and export it as GLB",
"Make a 3D-printable knight figurine and export STL"
],
"examplePrompts_i18n": {
"zh-CN": [
"生成一个低多边形的宝箱 3D 模型,导出 FBX 给 Unity 用",
"把这张概念图变成带贴图的 3D 模型,导出 GLB",
"生成一个可 3D 打印的骑士小雕像,导出 STL 文件"
]
}
]
},
{
"name": "kicad",
Expand Down
8 changes: 4 additions & 4 deletions plugins/tripo-3d/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"name": "tripo-3d",
"version": "0.1.3",
"description": "Generate textured, rig-ready 3D models from a text prompt or a reference image with Tripo, and export GLB/FBX/OBJ/STL/USDZ/3MF straight into your project. Connect your China-mainland Tripo account once in the browser (OAuth), no API key pasting.",
"version": "0.1.5",
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts.",
"description_i18n": {
"en": "Generate textured, rig-ready 3D models from a text prompt or a reference image with Tripo, and export GLB/FBX/OBJ/STL/USDZ/3MF straight into your project. Connect your China-mainland Tripo account once in the browser (OAuth), no API key pasting.",
"zh-CN": "用 Tripo 从一句话或一张图生成带贴图、可绑骨的 3D 模型,支持动画、减面与 GLB/FBX/OBJ/STL/USDZ/3MF 导出,文件直接落到项目里。浏览器里授权一次国内站 Tripo 账号即可使用,无需粘贴 API Key。"
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts.",
"zh-CN": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts."
},
"author": {
"name": "VAST",
Expand Down
14 changes: 13 additions & 1 deletion plugins/tripo-3d/.mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,19 @@
"type": "http",
"url": "https://developers.tripo3d.com/mcp",
"enabled": true,
"timeoutMs": 90000
"timeoutMs": 90000,
"headers": {
"X-Tripo-Distribution": "zcode_plugin"
}
},
"tripo-global": {
"type": "http",
"url": "https://openapi-mcp.tripo3d.ai/mcp",
"enabled": true,
"timeoutMs": 90000,
"headers": {
"X-Tripo-Distribution": "zcode_plugin"
}
}
}
}
8 changes: 4 additions & 4 deletions plugins/tripo-3d/.zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"name": "tripo-3d",
"version": "0.1.4",
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"version": "0.1.5",
"description": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts.",
"description_i18n": {
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Requires a mainland China Tripo account.",
"zh-CN": "用文字或图片生成带贴图的 3D 模型,添加骨骼与动画、精简模型面数,导出用于游戏或 3D 打印的素材。需使用 Tripo 国内站账号。"
"en": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts.",
"zh-CN": "Generate textured 3D models from text or images, add rigging and animation, simplify meshes, and export assets for games or 3D printing. Works with mainland China and international Tripo accounts."
},
"author": {
"name": "VAST",
Expand Down
104 changes: 68 additions & 36 deletions plugins/tripo-3d/README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,47 @@
# Tripo 3D

[中文](./README_CN.md)
## 0.1.5

Works with both China-mainland and international Tripo accounts: the plugin
ships one MCP server per region, `tripo` for the China site and `tripo-global`
for the international site, and you authorize the one your account belongs to.

A user's explicitly chosen compatible model overrides usage-based defaults.
Game/realtime recipes explicitly prefer **P2** (more credits than H/P1), the
P-series default; **P1** is used only when the user names it or picks it for lower
cost and speed, and v3.1 for film/render/print. Rigs pass the model
explicitly, v3.0 for bipeds and v2.5 for animals (the API's own default, v1.0,
rigs bipeds only), with animation presets selected
from the upstream rig model. Retopology v3.0's
`smart_uv` and standalone `tripo_smart_uv` are distinct billed workflows.
Fast textures require v3.5; `chat_image_1` is retired.

The plugin runs through the Tripo MCP tools only — there is no CLI path, and
missing authorization is never a reason to switch to one. PBR stays off unless
you explicitly ask for it. A plan is advisory, not a price quote or budget lock.
Show estimated or unestimated costs, cite the source, region and date of any
static list estimate, and obtain explicit consent. Never switch accounts silently.
The hook also enforces the PBR default and explicit model/billing decisions.

The official Tripo plugin for ZCode. Generate textured 3D models from a text
prompt or a reference image, with rigging, animation, retopology and format
conversion (GLB/FBX/OBJ/STL/USDZ/3MF), and land the files directly in your
project. Built for games, film, AR and 3D printing.

Connect your **China-mainland** Tripo account once in the browser
(developers.tripo3d.com) — no API key pasting. This build's MCP endpoint is
China-only; overseas-site accounts need the overseas Tripo 3D plugin build, or
the CLI with `--region ov`.
Connect your Tripo account once in the browser — no API key pasting. Both
**China-mainland** (developers.tripo3d.com) and **international**
(developers.tripo3d.ai) accounts work: the plugin ships one MCP server per
region and you authorize only the one your account belongs to.

## Components

| Component | What it does |
| --- | --- |
| Skill `tripo-3d` | Main workflow: execution-path selection, authorization guidance, MCP workflow, scenario → tool-chain mapping, input handling, credit rules; plus the fallback `tripo-cli` path |
| Skill `tripo-3d` | Main workflow: tool check, authorization guidance, MCP workflow, scenario → tool-chain mapping, input handling, credit rules |
| Skill `tripo-game-asset` | Game-asset recipes: budgeted low-poly props, LOD chains, rigged characters with locomotion clips, wiring into Unity/Unreal/Godot/Three.js |
| MCP server `tripo` | Remote Streamable HTTP server `https://developers.tripo3d.com/mcp` (OAuth 2.1) exposing 26 tools such as `tripo_plan`, `tripo_text_to_3d`, `tripo_image_to_3d`, `tripo_task_wait`, `tripo_mesh_edit`, `tripo_rig`, `tripo_animate`, `tripo_convert` |
| Hook `SessionStart` | Injects five hard rules (async waiting, link expiry, credit confirmation / `tripo_plan`, browser authorization, honest failure reporting) so they hold even when no skill was triggered |
| MCP server `tripo` | China site: remote Streamable HTTP server `https://developers.tripo3d.com/mcp` (OAuth 2.1), including `tripo_plan`, generation, rigging, conversion and `tripo_smart_uv`; available tool schemas are authoritative |
| MCP server `tripo-global` | International site: the same tools on `https://openapi-mcp.tripo3d.ai/mcp` (OAuth 2.1) |
| Hook `SessionStart` | Injects seven rules: async waiting, link expiry, credit confirmation, browser authorization, honest failures, PBR off by default and explicit model/billing decisions, plus a region hint from the system time zone |

## Usage

Expand All @@ -36,15 +58,18 @@ from the Skills group.

### First-time authorization

The Tripo MCP server needs a one-time authorization:

1. Open **Settings → MCP**, find the Tripo row under "Plugin MCP servers"
(it shows "Authorization required") and click **Open authorization**.
2. The system browser opens the Tripo authorization page for the **China site**
(developers.tripo3d.com — +86 SMS sign-in, Alipay top-up). There is no
region picker on this page. You can sign up on the spot; new accounts get
free credits. An international-site account will not authorize against this
build — use the overseas plugin or `tripo-cli` with `--region ov`.
Authorize the Tripo MCP server for your account's region once:

1. Open **Settings → MCP Servers**. Under "Plugin MCP servers" there are two Tripo
rows, both showing "Authorization required": `tripo` for a China-mainland
account and `tripo-global` for an international account. Click
**Open authorization** on the row for your account; the other row can stay
as it is.
2. The system browser opens that site's authorization page: `tripo` uses the
**China site** (developers.tripo3d.com — +86 SMS sign-in, Alipay top-up),
`tripo-global` the **international site** (developers.tripo3d.ai — email
sign-in, Stripe top-up). The page has no region picker. You can sign up on
the spot; new accounts get free credits.
3. The page shows a one-time verification code and opens the Tripo console:
sign in, type the code into **Verification code**, click **Authorize**.
4. ZCode reconnects and loads the tools automatically. To revoke access,
Expand All @@ -53,35 +78,42 @@ The Tripo MCP server needs a one-time authorization:

## Dependencies, network access and side effects

- **Network**: MCP tool calls go to `https://developers.tripo3d.com/mcp`;
authorization redirects to the China Tripo console
(developers.tripo3d.com). Results are downloaded from Tripo's CDN through
short-lived links (about 5 minutes).
- **Network**: ZCode connects to both MCP endpoints,
`https://developers.tripo3d.com/mcp` (China site) and
`https://openapi-mcp.tripo3d.ai/mcp` (international site); tool calls go
only to the one you authorized, and authorization redirects to that site's
Tripo console. Results are downloaded from Tripo's CDN through short-lived
links (about 2 hours).
- **Account and billing**: every generation spends credits from your own
Tripo account; each tool reports `credits_consumed`, failed tasks are
refunded automatically. The skill drafts the chain with `tripo_plan`,
Tripo account; use task status and the usage ledger for actual charges. Failed
tasks are refunded automatically. The skill drafts the chain with `tripo_plan`,
checks the balance and asks before generating a batch.
- **File writes**: only when you ask for the model on disk, the agent
downloads it into your project with `curl`. The hook and the MCP server
downloads it into your project with `curl`. The hook and the MCP servers
write nothing.
- **Command execution**: on the MCP path, shell commands run only to upload a
local image/model (the `curl` returned by `tripo_upload_ticket`) or to
download a result. The fallback CLI path downloads and runs
[tripo-cli](https://www.npmjs.com/package/tripo-cli) (MIT, via
`npx tripo-cli@latest`), only for jobs that need it (e.g. bulk generation),
and says so first.
- **Command execution**: shell commands run only to upload a local image/model
(the `curl` returned by `tripo_upload_ticket`) or to download a result. The
plugin never installs or runs a command-line client, including after an MCP
failure, missing authorization, batch work or a request to save files locally.
- **Hook**: `hooks/session-start.mjs` needs `node` on PATH. It reads the
event from stdin and prints a fixed text to stdout; no network, no file
access.
- **No data collection**: the plugin contains no telemetry; account
credentials are managed by ZCode's credential store and never pass through
the chat.
event from stdin and prints the rules plus a region hint derived from the
system time zone to stdout; no network, no file access.
- **Telemetry**: the plugin has no independent analytics SDK. When enabled on
the Tripo MCP server you authorized (China or international site; both
record the same fields), analytics can record tool results, task
metadata and the Tripo account ID when resolved. Both MCP servers declare the
non-credential `X-Tripo-Distribution: zcode_plugin` header; if the host
forwards it, the server records the distribution channel separately from
the detected client (such as ZCode, Claude, or unknown). Analytics excludes
prompts, API keys, OAuth tokens, file paths and signed download links.
Account credentials are managed by ZCode's credential store and never pass
through the chat.

## Provenance and license

- Plugin: MIT, by [VAST](https://www.tripo3d.ai).
- Both skills are ported from Tripo's official Kimi / Codex plugins (also
maintained by VAST, MIT).
- The MCP server and `tripo-cli` are official Tripo implementations;
- Both MCP servers run the official Tripo implementation;
generated content is subject to the
[Tripo API content policy](https://platform.tripo3d.ai/docs).
56 changes: 0 additions & 56 deletions plugins/tripo-3d/README_CN.md

This file was deleted.

Loading
Loading