build123d-mcp

Ein MCP-Server (Model Context Protocol), der build123d-CAD-Operationen als Tools bereitstellt und es KI-Assistenten ermöglicht, 3D-Geometrien interaktiv zu erstellen, zu inspizieren und zu iterieren.

Warum

Wenn eine KI build123d-Skripte schreibt, arbeitet sie blind – sie kann die erzeugte Geometrie nicht sehen. Dieser Server schließt den Feedback-Kreislauf: Die KI kann Geometrie erstellen, Ansichten rendern, Abmessungen abfragen und Fehler schrittweise korrigieren, anstatt vollständige Skripte zu schreiben und auf deren Korrektheit zu hoffen.

Related MCP server: 3D MCP Server

Tools

• execute — führt build123d-Python-Code in einer persistenten Sitzung aus; verwenden Sie show(shape, name), um benannte Teile zu registrieren

• render_view — rendert eine oder mehrere Formen als PNG oder SVG; unterstützt Baugruppen-Komposition, hochwertige Tessellierung und Querschnitts-Schnittebenen

• measure — fragt Bounding Box, Volumen, Oberfläche, Topologie, minimale Wandstärke oder Abstand zwischen zwei benannten Körpern ab

• export — exportiert als STEP, STL oder beides in einem Aufruf; zielt auf ein benanntes Objekt oder die aktuelle Form ab

• session_state — vollständiger JSON-Snapshot aktiver Formen, benannter Objekte und Snapshot-Namen

• health_check — überprüft die VTK/SVG/STEP/STL-Abhängigkeiten auf vollständige Funktionsfähigkeit vor Arbeitsbeginn

• save_snapshot / restore_snapshot / diff_snapshot — speichert, stellt wieder her und vergleicht den geometrischen Zustand

• interference — prüft das Schnittvolumen zwischen zwei benannten Formen

• list_objects — listet alle benannten Formen mit Geometrie-Statistiken auf

• version — gibt die Server-Version zurück

• reset — setzt die Sitzung auf den leeren Zustand zurück

Siehe llms.md für die vollständige Tool-Referenz und Nutzungsmuster.

Anforderungen

• uv

• Ein MCP-kompatibler Client (Claude Code, Claude Desktop, Cursor, etc.)

Alle Python-Abhängigkeiten (build123d, vtk, etc.) werden automatisch durch uv installiert.

Installation

Kein Klonen erforderlich. Direkt von PyPI installieren:

pip install build123d-mcp

Oder verwenden Sie einfach uv tool run — es lädt das Paket herunter und führt es in einem Schritt aus, ohne dass eine vorherige Installation erforderlich ist (siehe unten).

Hinzufügen zu MCP-Clients

Der Server läuft über stdio — der Client startet ihn als Subprozess mit uv tool run build123d-mcp.

Hinweis zur Python-Version. Alle Beispiele unten verwenden --python 3.12. VTK und cadquery-ocp bieten derzeit noch keine Wheels für Python 3.13+ an, daher ist die Festlegung auf 3.12 erforderlich. uv lädt automatisch ein verwaltetes Python 3.12 herunter, falls Sie noch keines haben.

Claude Code

Fügen Sie dies zur .mcp.json Ihres Projekts (oder ~/.claude/mcp.json für die globale Nutzung) hinzu:

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

Starten Sie Claude Code nach dem Bearbeiten neu. Die Tools erscheinen automatisch, sobald die Verbindung hergestellt ist.

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Cursor

Öffnen Sie Settings → MCP und fügen Sie einen neuen Servereintrag hinzu oder bearbeiten Sie ~/.cursor/mcp.json:

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

VS Code (GitHub Copilot / Continue)

Für die Continue-Erweiterung, fügen Sie dies zu .continue/config.json hinzu:

{
  "mcpServers": [
    {
      "name": "build123d-mcp",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  ]
}

Für GitHub Copilot mit MCP-Unterstützung, fügen Sie dies zu .vscode/mcp.json in Ihrem Arbeitsbereich hinzu:

{
  "servers": {
    "build123d-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

System-Prompt

Für beste Ergebnisse fügen Sie den Inhalt von default_prompt.md als System-Prompt in Ihren KI-Client ein. Dies weist den Assistenten an, schrittweise zu arbeiten, die Geometrie nach jedem Schritt zu überprüfen und die Tools in der richtigen Reihenfolge zu verwenden.

Status

Aktive Entwicklung (v0.1.0).