trident-mcp

trident-mcp is a Go MCP server for AI-assisted 3D model generation and post-processing. It runs as a single stdio binary and currently uses the Tripo v3 API behind provider capability interfaces.

Potion bottle generated with the Tripo v3 multiview pipeline

Quick Start

Build locally:

bash

go build -o ./trident-mcp ./cmd/trident-mcp

Run with a Tripo key:

bash

TRIPO_API_KEY=tsk_your_key_here ./trident-mcp

One-command development bootstrap and smoke check:

bash

go mod download && go install github.com/golangci/golangci-lint/cmd/golangci-lint@v2.11.4 && go test ./... -count=1

MCP Client Config

config.json

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

Documentation Map

Need	Read
Agent instructions and common change patterns	AGENTS.md
Architecture, module boundaries, and Mermaid diagrams	ARCHITECTURE.md
MCP tool surface, models, and Tripo v3 behavior notes	docs/MCP_TOOLS.md
Local setup, verification commands, and release workflow	docs/DEVELOPMENT.md
Runtime config, E2E tests, and operational caveats	docs/OPERATIONS.md
Design invariants and provider-boundary rationale	docs/design/provider-boundaries.md
Architecture decision records	docs/adr/
Security policy and threat model	SECURITY.md, THREAT_MODEL.md

Configuration

Variable	Required	Default	Description
`TRIPO_API_KEY`	Yes	none	Tripo API key used for generation, polling, download, and post-processing calls
`TRIPO_BASE_URL`	No	`https://openapi.tripo3d.ai/v3`	Override for private deployments or tests
`MODEL_OUTPUT_DIR`	No	`~/generated_models`	Directory where downloaded models are written

Tool Overview

The server exposes tools for text/image/multiview 3D generation, image preparation, splats, async task polling, account balance and usage, file uploads, downloads, conversion, retopology, stylization, texture/refine/segment/complete workflows, rig checks, rigging, animation retargeting, and model/config inspection.

See docs/MCP_TOOLS.md for the full tool contract and known Tripo v3 quirks.

Development

The normal local gate is:

bash

go build ./cmd/trident-mcp
go test ./... -count=1
go vet ./...
golangci-lint run
go run golang.org/x/vuln/cmd/govulncheck@latest ./...

Live E2E tests require TRIPO_API_KEY and can spend credits when opt-in generation flags are set. See docs/OPERATIONS.md.

License

Apache-2.0. See LICENSE.