trident-mcp

trident-mcp ist ein Go-MCP-Server für die KI-gestützte 3D-Modellgenerierung und Nachbearbeitung.

Der Server ist client-agnostisch und arbeitet unabhängig mit jedem MCP-kompatiblen Client zusammen. Sie benötigen keine zusätzlichen Skills oder weitere MCP-Server, um die grundlegenden Tools für 3D-Generierung, Polling, Download und Nachbearbeitung zu nutzen.

Er wird derzeit mit einem Tripo-basierten Provider ausgeliefert und stellt Tools für Folgendes bereit:

Text-zu-3D-Generierung
Bild-zu-3D-Generierung
Multiview-zu-3D-Generierung
Asynchrones Task-Polling
Modell-Download
Retopologie
Formatkonvertierung
Stilisierung
Modellkatalog- und Serverkonfigurationsprüfung

Anforderungen

Go 1.25+
Ein Tripo-API-Schlüssel in TRIPO_API_KEY

Installation

Lokal bauen:

go build ./cmd/trident-mcp

Oder mit Go installieren:

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

Konfiguration

Der Server liest die Konfiguration aus Umgebungsvariablen:

Variable	Erforderlich	Standard	Beschreibung
`TRIPO_API_KEY`	Ja	keine	Tripo-API-Schlüssel für Generierungs- und Bearbeitungsaufrufe
`MODEL_OUTPUT_DIR`	Nein	`~/generated_models`	Verzeichnis, in das heruntergeladene Modelle geschrieben werden

Ausführung

Der Server kommuniziert über stdio mit MCP:

TRIPO_API_KEY=tsk_your_key_here trident-mcp

Beispiel für eine MCP-Client-Konfiguration:

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

Tools

Generierung

text_to_3d
image_to_3d
multiview_to_3d

Diese Tools starten asynchrone Tasks. Verwenden Sie task_status, um den Abschluss abzufragen, und dann download_model, um das Task-Ergebnis abzurufen.

Status und Download

task_status
download_model

download_model speichert das tatsächliche Ausgabeformat des Tasks. Wenn Sie ein anderes Format benötigen, führen Sie zuerst convert_format aus und laden Sie dann den Konvertierungs-Task herunter.

Nachbearbeitung

retopologize
convert_format
stylize

Introspektion

list_models
get_config

get_config meldet das aktive Backend, das Ausgabeverzeichnis und die Serverversion.

Skills

Das Repo enthält auch begleitende Agenten-Skills unter skills/:

skills/3d-gen/SKILL.md
skills/multiview-3d/SKILL.md
skills/3d-to-blender/SKILL.md

Diese Skills sind optional. Der MCP-Server selbst funktioniert einwandfrei für sich allein in jedem MCP-Client.

Einige der begleitenden Skills sind darauf ausgelegt, trident-mcp mit gemini-media-mcp für eine umfassendere automatisierte Pipeline zu kombinieren. In diesem Setup kann gemini-media-mcp bei der Ideenfindung, der Generierung von Referenzbildern und der Erstellung von Bildern aus mehreren Blickwinkeln helfen, während trident-mcp die Rekonstruktion und Nachbearbeitung übernimmt. Diese Kombination ermöglicht einen vollständigeren Ablauf von der Idee bis zum fertigen 3D-Modell.

Entwicklung

Führen Sie die lokalen Prüfungen aus:

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

Es gibt auch einen optionalen E2E-Smoke-Test für Live-Tripo-Uploads:

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

Release

GitHub Actions führt Unit-Prüfungen bei Pushes und Pull Requests durch und führt den E2E-Smoke-Test auf main und Versions-Tags aus. Getaggte Releases werden mit GoReleaser erstellt.

Artefakte werden mit der Release-Version versehen, damit die Binärdatei und die MCP-Implementierungsmetadaten synchron bleiben.