Połącz CAD z narzędziami AI.

MCP · CLI v0.22.0 · 2026-10-28

Sprawdzone połączenie MCP bez interfejsu

Klient Node.js JSON-RPC utworzył w oficjalnej CLI bryłę 40 × 30 × 10 mm (12 000 mm³). Po zmianie part_length na 50 mm zmierzono 15 000 mm³. Po otwarciu pliku natywnego parametr nadal zmieniał geometrię, a otwarty STEP zachował wymiary i objętość.

Konfiguracja dotyczy CLI v0.22.0 z jawnym --headless. W tej wersji samo mcp może automatycznie połączyć się z uruchomioną aplikacją desktopową. Most desktopowy używa --connect. W starszym CLI najpierw sprawdź mcp --help.

CLI v0.22.0 · GitHub Release ↗

Sześć kontroli wykonano na jednym prostopadłościanie w CLI v0.22.0 na macOS x64. Po otwarciu pliku natywnego ponownie zmieniono parametr. STEP otwarto w tej samej CLI: sprawdzono geometrię bryły, a nie oryginalną historię ani migrację z Fusion, FreeCAD lub SOLIDWORKS. Interfejsów Claude i mostu desktopowego nie testowano.

Utwórz, zmień, zapisz i wyeksportuj rzeczywisty model

Uruchom osobną sesję headless podanej CLI, zainicjuj MCP i pobierz listę narzędzi. Utwórz osobny folder i udostępnij go przez --allow-path w konfiguracji serwera. Zastąp <practice-folder> bezwzględną ścieżką folderu. Przykłady JSON są argumentami tools/call, a nie konfiguracją serwera ani poleceniem w języku naturalnym.

1. 1. Utwórz bryłę z part_length = 40 mm

   40 × 30 × 10 mm · 12 000 mm³

   Pokaż użyte wywołania narzędzi

   [
     {
       "name": "execute",
       "arguments": {
         "command": "file.new",
         "params": {
           "name": "MCP practice"
         }
       }
     },
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "40 mm"
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "solid.box",
         "params": {
           "length": "part_length",
           "width": 30,
           "height": 10
         }
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

2. 2. Zmień part_length na 50 mm i zmierz

   50 × 30 × 10 mm · 15 000 mm³

   Pokaż użyte wywołania narzędzi

   [
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "50 mm"
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

3. 3. Zapisz plik natywny, utwórz nowy projekt i otwórz plik

   50 × 30 × 10 mm · 15 000 mm³

   Pokaż użyte wywołania narzędzi

   [
     {
       "name": "execute",
       "arguments": {
         "command": "file.save",
         "params": {
           "path": "<practice-folder>/mcp-box.solidcraft"
         }
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "file.new",
         "params": {
           "name": "Reopen check"
         }
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "doc.open",
         "params": {
           "path": "<practice-folder>/mcp-box.solidcraft"
         }
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

4. 4. Zmień parametr po otwarciu i sprawdź geometrię

   40 × 30 × 10 mm · 12 000 mm³

   Pokaż użyte wywołania narzędzi

   [
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "40 mm"
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

5. 5. Przywróć 50 mm i zmierz

   50 × 30 × 10 mm · 15 000 mm³

   Pokaż użyte wywołania narzędzi

   [
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "50 mm"
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

6. 6. Zapisz, wyeksportuj STEP i otwórz w nowym projekcie

   50 × 30 × 10 mm · 15 000 mm³

   Pokaż użyte wywołania narzędzi

   [
     {
       "name": "execute",
       "arguments": {
         "command": "file.save",
         "params": {
           "path": "<practice-folder>/mcp-box.solidcraft"
         }
       }
     },
     {
       "name": "export",
       "arguments": {
         "path": "<practice-folder>/mcp-box.step",
         "format": "step"
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "file.new",
         "params": {
           "name": "STEP reopen check"
         }
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "doc.open",
         "params": {
           "path": "<practice-folder>/mcp-box.step"
         }
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

Oficjalna dokumentacja MCP · sprawdzona wersja ↗

Gdy połączenie się nie uruchamia

1. Uruchom mcp --help. Jeśli klient nie znajduje programu, użyj bezwzględnej ścieżki pliku wykonywalnego.
2. Przed modelowaniem sprawdź inicjalizację i tools/list. Odpowiedzi protokołu należą do stdout, diagnostyka do stderr.
3. Do zapisu utwórz osobny folder i podaj jego ścieżkę po --allow-path. Test daje dostęp wyłącznie do własnego folderu roboczego.