PhysBox: MCP

PhysBox: MCP — это сервер протокола контекста модели (MCP), который позволяет LLM и MCP-клиентам (таким как Claude Code или Claude Desktop) программно взаимодействовать с четырьмя симуляционными веб-приложениями в браузере:

Вся связь осуществляется через JSON по WebSocket напрямую с веб-приложением в вашем браузере — автоматизация браузера или извлечение DOM не требуются.

🧠 Единственная AI-нативная модель физического мира

В отличие от статической генерации кода или офлайн-вывода файлов, PhysBox предоставляет AI-агентам интерактивную эталонную модель мира. LLM выполняют 81 типизированный вызов инструмента для наблюдения за пространственной кинематикой, формами сигналов в узлах схем и предупреждениями безопасности G-кода, что позволяет им итеративно самостоятельно исправлять проекты.

💬 Примеры подсказок для агентов в Claude Code и Cursor

Вставьте любую из этих подсказок напрямую в вашего агента, подключённого к MCP:

• Volt (Электроника):

  «Оптимизируйте значения RC-фильтра в активной схеме Volt для достижения частоты среза 1 кГц, затем выполните circuit_run_sim и постройте график амплитудно-частотной характеристики.»

• Mesh (3D-физика и CAD):

  «Напишите параметрический кронштейн в OpenSCAD в Mesh с отверстиями под винты 4 мм, выполните проверку коллизий MuJoCo с помощью physics_check_collisions и экспортируйте STL с осью Z вверх.»

• Etch (ЧПУ и лазер):

  «Импортируйте этот векторный SVG-логотип, примените 2-проходные подачи с шагом 3 мм для фанеры, проверьте предупреждения безопасности концевой фрезы и сгенерируйте G-код GRBL.»

Related MCP server: Tesseron

Как это работает

PhysBox: MCP работает как локальный сервер-компаньон, который устанавливает WebSocket-ретранслятор на порту 3142.

Когда вы открываете любое из симуляционных веб-приложений, они подключаются напрямую к этому WebSocket-ретранслятору. Когда MCP-клиент выполняет вызов инструмента, команда поступает от клиента к серверу-компаньону, перенаправляется в активную вкладку браузера, и результаты возвращаются обратно.

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

Установка

Установите сервер-компаньон напрямую из PyPI:

pip install physbox-mcp

Использование и настройка

1. Откройте веб-приложения

Запустите или откройте симуляционные веб-приложения в вашем веб-браузере:

• Flux: flux.physbox.io

• Volt: volt.physbox.io

• Mesh: mesh.physbox.io

• Etch: etch.physbox.io

Как только страница загрузится, она автоматически регистрируется на сервере-компаньоне WebSocket.

2. Настройте ваш MCP-клиент

Для Claude Desktop

Добавьте следующий блок в файл конфигурации Claude Desktop (обычно находится по адресу AppData/Roaming/Claude/claude_desktop_config.json в Windows или ~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

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

Для Claude Code / Локального рабочего пространства (.mcp.json)

Добавьте файл .mcp.json в корень вашего проекта (или обновите глобальную конфигурацию по адресу ~/.claude/mcp.json):

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

Разрабатываете из исходного кода? Если запускаете напрямую из клонированного репозитория или виртуального окружения, используйте ваш интерпретатор Python:

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

(При необходимости замените "python" на путь к исполняемому файлу Python вашего виртуального окружения, например /path/to/venv/bin/python).

Для Google Antigravity IDE

В конфигурациях Windows/WSL Antigravity IDE читает конфигурацию из глобального каталога конфигурации. Поскольку глобальный каталог (~/.gemini/config/) может быть защищён от записи, вам следует связать его с доступной для записи папкой ~/.gemini/antigravity/:

1. В PowerShell создайте жёсткую ссылку из глобального целевого каталога конфигурации в доступный для записи пользовательский каталог:

   # 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. Добавьте конфигурацию WSL physbox-mcp в ваш mcp_config.json (заменив <your-wsl-distro> на ваш дистрибутив WSL, например Ubuntu-20.04):

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

   (Если разрабатываете из исходного кода в WSL, укажите в args двоичный файл Python вашего виртуального окружения и -m physbox_mcp.server).

3. Перезапустите IDE (или закройте и перезагрузите сеанс чата агента), чтобы зарегистрировать инструменты MCP нативно.

3. Запустите сервер-компаньон вручную (опционально)

Если вы запускаете сервер в режиме HTTP, а не Stdio, вы можете выполнить:

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

Или настроить пользовательские параметры порта:

physbox-mcp --port=4000

Разработка и вклад

Инструкции по локальной разработке, изменению схем, расширению определений инструментов и ручной сборке см. в README_DEV.md.