Tripo AI MCP-Server

Dies ist ein Model Context Protocol (MCP)-Server für die Tripo3D AI API. Er ermöglicht es KI-Assistenten, mit den 3D-Generierungsfunktionen von Tripo zu interagieren.

Funktionen

• Text zu 3D: Generieren Sie 3D-Modelle aus Text-Prompts.

• Bild zu 3D: Generieren Sie 3D-Modelle aus Bildern (unterstützt lokale Pfade, URLs oder vorab hochgeladene Tokens).

• Multiview zu 3D: Generieren Sie 3D-Modelle aus Bildern mit mehreren Ansichten (lokale Pfade, URLs oder Tokens).

• Modell verfeinern: Verbessern Sie die Qualität eines Modellentwurfs.

• Stilisierung: Wenden Sie Stile (Lego, Voxel, Voronoi, Minecraft) auf ein Modell an.

• Modell texturieren: Texturieren Sie ein vorhandenes Modell neu, optional gesteuert durch einen Text- oder Bild-Prompt.

• Modell konvertieren: Exportieren Sie ein Modell in ein anderes Format (GLTF, FBX, OBJ, STL, USDZ, 3MF).

• Animations-Workflow: Rigging-Fähigkeit prüfen → Modell riggen → eine voreingestellte Animation neu zuweisen.

• Aufgabenstatus: Überprüfen Sie den Status und rufen Sie die Ausgabe-URLs einer beliebigen Generierungsaufgabe ab.

• Datei hochladen: Laden Sie eine lokale Bilddatei hoch und erhalten Sie ein wiederverwendbares Datei-Token.

Related MCP server: Tripo3D MCP

Installation

npm install -g tripo-ai-mcp-server

Konfiguration

Sie benötigen ein Tripo3D API-Secret. Sie können es in einer .env-Datei festlegen oder als Umgebungsvariable TRIPO_API_SECRET übergeben.

Client-Konfiguration

Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu (normalerweise unter %APPDATA%\Claude\claude_desktop_config.json unter Windows oder ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "tripo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "tripo-ai-mcp-server"
      ],
      "env": {
        "TRIPO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Verwendung

Starten Sie den Server:

tripo-ai-mcp-server

Tools

• text_to_3d: Generiert ein 3D-Modell aus einer Textbeschreibung.

• image_to_3d: Generiert ein 3D-Modell aus einem Bild (lokaler Pfad, URL oder vorab hochgeladenes Token).

• multiview_to_3d: Generiert ein 3D-Modell aus Bildern mit mehreren Ansichten.

• get_task_status: Überprüft den Aufgabenstatus und ruft die Ausgabe-URLs des Modells ab.

• upload_file: Lädt eine lokale Bilddatei hoch und gibt ein wiederverwendbares Datei-Token zurück.

• refine_model: Verfeinert einen Modellentwurf zur Qualitätsverbesserung.

• animate_prerigcheck: Überprüft, ob ein Modell für das Rigging geeignet ist.

• rig_model: Riggt ein Modell, damit es animiert werden kann.

• retarget_animation: Wendet eine voreingestellte Animation auf ein geriggtes Modell an.

• stylize_model: Wendet einen visuellen Stil auf ein Modell an (Lego, Voxel, Voronoi, Minecraft).

• convert_model: Konvertiert ein Modell in ein anderes Dateiformat (GLTF, FBX, OBJ, STL, USDZ, 3MF).

• texture_model: Generiert neue Texturen für ein vorhandenes Modell.

Entwicklung

1. Klonen Sie das Repo.

2. npm install

3. npm run build

4. node dist/index.js

Veröffentlichung auf npm

Ein GitHub Actions-Workflow (.github/workflows/publish.yml) veröffentlicht das Paket automatisch auf npm, sobald ein neues GitHub-Release erstellt wird.

Einmalige Einrichtung:

1. Generieren Sie ein npm Automation-Token unter npmjs.com → Avatar → Access Tokens → Generate New Token → Automation.

2. Fügen Sie es als Repository-Secret in GitHub hinzu: Settings → Secrets and variables → Actions → New repository secret → nennen Sie es NPM_TOKEN.

Um eine neue Version zu veröffentlichen:

1. Erhöhen Sie die "version" in der package.json.

2. Committen und pushen Sie die Änderungen.

3. Erstellen Sie ein neues GitHub-Release (markieren Sie es mit der Version, z. B. v1.1.0). Der Workflow wird automatisch ausgelöst und veröffentlicht auf npm.

Lizenz

ISC