PhysBox: MCP

PhysBox: MCP ist ein Model Context Protocol (MCP)-Server, der es LLMs und MCP-Clients (wie Claude Code oder Claude Desktop) ermöglicht, programmatisch mit den vier Simulations-Webanwendungen im Browser zu interagieren:

Die gesamte Kommunikation erfolgt über JSON per WebSocket direkt zur Web-App in Ihrem Browser – es ist keine Browser-Automatisierung oder DOM-Scraping erforderlich.

🧠 Das einzige KI-native physikalische Weltmodell

Im Gegensatz zu statischer Codegenerierung oder Offline-Dateiausgaben bietet PhysBox KI-Agenten ein interaktives Ground-Truth-Weltmodell. LLMs führen 81 typisierte Tool-Aufrufe aus, um räumliche Kinematik, Schaltungsknoten-Wellenformen und G-Code-Sicherheitswarnungen zu beobachten, sodass sie Designs iterativ selbst korrigieren können.

💬 Beispiel-Agenten-Prompts für Claude Code & Cursor

Fügen Sie einen dieser Prompts direkt in Ihren MCP-verbundenen Agenten ein:

• Volt (Elektronik):

  "Optimieren Sie die RC-Filterwerte im aktiven Volt-Schaltplan, um eine Grenzfrequenz von 1 kHz zu erreichen, führen Sie dann circuit_run_sim aus und plotten Sie den Amplitudengang."

• Mesh (3D-Physik & CAD):

  "Schreiben Sie eine parametrische OpenSCAD-Montagehalterung in Mesh mit 4mm-Schraublöchern, führen Sie eine MuJoCo-Kollisionsstabilitätsprüfung mit physics_check_collisions durch und exportieren Sie das Z-up STL."

• Etch (CNC & Laser):

  "Importieren Sie dieses Vektor-SVG-Logo, wenden Sie 2-Pass-3mm-Zustellungen für Sperrholz an, überprüfen Sie die Sicherheitswarnungen für den Schaftfräser und generieren Sie GRBL G-Code."

Related MCP server: Tesseron

So funktioniert es

PhysBox: MCP fungiert als lokaler Begleitserver, der ein WebSocket-Relay auf Port 3142 einrichtet.

Wenn Sie eine der Simulations-Web-Apps öffnen, verbinden sie sich direkt mit diesem WebSocket-Relay. Wenn ein MCP-Client einen Tool-Aufruf ausführt, fließt der Befehl vom Client zum Begleitserver, wird an den aktiven Browser-Tab weitergeleitet, und die Ergebnisse fließen zurück.

MCP Client (e.g. Claude Desktop)
  └── spawns → physbox-mcp (stdio)
                 └── WebSocket Server (ws://localhost:3142)
                                ├── Flux
                                ├── Volt
                                ├── Mesh
                                └── Etch

Installation

Installieren Sie den Begleitserver direkt von PyPI:

pip install physbox-mcp

Verwendung & Einrichtung

1. Öffnen Sie die Webanwendungen

Starten Sie die Simulations-Webanwendungen in Ihrem Webbrowser oder greifen Sie darauf zu:

• Flux: flux.physbox.io

• Volt: volt.physbox.io

• Mesh: mesh.physbox.io

• Etch: etch.physbox.io

Sobald eine Seite vollständig geladen ist, registriert sie sich automatisch beim begleitenden WebSocket-Server.

2. Konfigurieren Sie Ihren MCP-Client

Für Claude Desktop

Fügen Sie den folgenden Block zu Ihrer Claude Desktop-Konfigurationsdatei hinzu (normalerweise unter AppData/Roaming/Claude/claude_desktop_config.json unter Windows oder ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "physbox-mcp": {
      "command": "physbox-mcp",
      "args": ["--stdio"]
    }
  }
}

Für Claude Code / Lokalen Arbeitsbereich (.mcp.json)

Fügen Sie eine .mcp.json-Datei zu Ihrem Projektstamm hinzu (oder aktualisieren Sie Ihre globale Konfiguration unter ~/.claude/mcp.json):

{
  "mcpServers": {
    "physbox-mcp": {
      "type": "stdio",
      "command": "physbox-mcp",
      "args": ["--stdio"]
    }
  }
}

Entwickeln Sie aus dem Quellcode? Wenn Sie direkt aus einem geklonten Repository oder einer virtuellen Umgebung ausführen, verwenden Sie Ihren Python-Interpreter:

{
  "mcpServers": {
    "physbox-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "physbox_mcp.server", "--stdio"]
    }
  }
}

(Ersetzen Sie "python" durch den Pfad zur Python-Ausführungsdatei Ihrer virtuellen Umgebung, falls erforderlich, z.B. /path/to/venv/bin/python).

Für Google Antigravity IDE

Unter Windows/WSL-Setups liest Antigravity IDE die Konfiguration aus dem globalen Konfigurationsverzeichnis. Da das globale Verzeichnis (~/.gemini/config/) möglicherweise schreibgeschützt ist, sollten Sie es mit dem beschreibbaren Ordner ~/.gemini/antigravity/ verknüpfen:

1. Erstellen Sie in PowerShell einen Hard Link vom globalen Konfigurationsziel zum beschreibbaren Benutzerverzeichnis:

   # Delete the empty placeholder file if it exists
   Remove-Item -Path "$env:USERPROFILE\.gemini\config\mcp_config.json" -Force -ErrorAction SilentlyContinue
   
   # Create a Hard Link to the writable copy
   New-Item -ItemType HardLink -Path "$env:USERPROFILE\.gemini\config\mcp_config.json" -Target "$env:USERPROFILE\.gemini\antigravity\mcp_config.json"

2. Fügen Sie die physbox-mcp WSL-Konfiguration zu Ihrer mcp_config.json hinzu (ersetzen Sie <your-wsl-distro> durch Ihre WSL-Distribution wie Ubuntu-20.04):

   {
     "mcpServers": {
       "physbox-mcp": {
         "command": "C:\\Windows\\system32\\wsl.exe",
         "args": [
           "-d",
           "<your-wsl-distro>",
           "physbox-mcp",
           "--stdio"
         ]
       }
     }
   }

   (Wenn Sie aus dem Quellcode in WSL entwickeln, übergeben Sie stattdessen die Python-Binärdatei Ihrer virtuellen Umgebung und -m physbox_mcp.server in args).

3. Starten Sie die IDE neu (oder schließen und laden Sie die Agent-Chat-Sitzung neu), um die MCP-Tools nativ zu registrieren.

3. Führen Sie den Begleitserver manuell aus (Optional)

Wenn Sie den Server im HTTP-Modus anstelle von Stdio ausführen, können Sie Folgendes ausführen:

# Starts HTTP server listening on port 3141 (default)
physbox-mcp

Oder konfigurieren Sie benutzerdefinierte Portparameter:

physbox-mcp --port=4000

Entwicklung & Beitrag

Anleitungen zur lokalen Entwicklung, zum Ändern von Schemata, zum Erweitern von Tool-Definitionen und zu manuellen Builds finden Sie in README_DEV.md.