Strona główna / Poradnik MCP

Sterowanie SolidCraft przez MCP (Claude, Codex i Cursor)

Główne źródło: docs/mcp.md / oficjalny poradnik MCP. Oficjalne przykłady klientów obejmują Claude Code i Claude Desktop. Codex i Cursor korzystają ze standardowej konfiguracji MCP przez stdio z dokumentacji MCP dla Codex od OpenAI i dokumentacji MCP Cursora, z tym samym poleceniem.

Co robi serwer MCP

solidcraft-cli mcp to serwer Model Context Protocol działający przez stdio. Agenci wykonują te same polecenia silnika co pasek narzędzi, skrypty i CLI – tworzą szkice i operacje, ustawiają parametry, mierzą, robią zrzuty ekranu, eksportują STEP/STL, cofają i ponawiają – bez otwierania okien dialogowych.

• Headless: sesja projektowa w tym samym procesie (zrzuty ekranu przez GPU / renderer programowy / awaryjnie przez CPU).
• Bridged: sterowanie uruchomioną aplikacją desktopową, startowaną z solidcraft --control PORT, dzięki czemu możesz obserwować pracę agenta.

Uruchomienie

# Headless (bez GUI)
solidcraft-cli mcp

# Headless z projektu lub skryptu
solidcraft-cli mcp --in part.solidcraft

# Połączenie (bridge) z uruchomioną aplikacją
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878

W instalacjach ze Snapa CLI nazywa się solidcraft.cli.

Używasz AppImage lub Snapa? Jak zdobyć solidcraft-cli dla MCP

Linuksowy AppImage uruchamia plik binarny GUI (solidcraft). Nie udostępnia mcp jako polecenia CLI. Serwer MCP to solidcraft-cli wewnątrz systemu plików squashfs AppImage – wypakuj go albo użyj .tar.gz/.deb, które zawierają oba narzędzia. Sprawdzone kroki, tabela pakietów i konfiguracje z bezwzględnymi ścieżkami dla Claude Code / Desktop / Cursora:

Poradnik: CLI z AppImage i MCP →

Claude Code

Według oficjalnej dokumentacji MCP:

claude mcp add solidcraft -- solidcraft-cli mcp

Albo plik projektu .mcp.json:

{
  "mcpServers": {
    "solidcraft": { "command": "solidcraft-cli", "args": ["mcp"] }
  }
}

Claude Desktop (bridged)

Oficjalny przykład pliku claude_desktop_config.json:

{
  "mcpServers": {
    "solidcraft": {
      "command": "/path/to/solidcraft-cli",
      "args": ["mcp", "--connect", "127.0.0.1:7878"]
    }
  }
}

Najpierw uruchom aplikację poleceniem solidcraft --control 7878.

Codex (CLI, rozszerzenie IDE, aplikacja desktopowa)

Dodaj serwer headless jednym poleceniem:

codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list     # sprawdź, czy jest zarejestrowany

Możesz też ręcznie edytować ~/.codex/config.toml, np. aby połączyć się z uruchomioną aplikacją i zezwolić na dostęp do folderu z projektami:

[mcp_servers.solidcraft]
command = "solidcraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]

W terminalowym interfejsie Codex polecenie /mcp pokazuje aktywne serwery. Jeśli solidcraft-cli nie jest w PATH, podaj pełną ścieżkę do pliku binarnego (Snap: solidcraft.cli; użytkownicy AppImage: zobacz, gdzie jest CLI). Niezależnie od tego wbudowany w SolidCraft panel „Czat z agentem” może uruchamiać Codex przez npm install -g @agentclientprotocol/codex-acp (oficjalna dokumentacja).

Cursor

{
  "mcpServers": {
    "solidcraft": {
      "type": "stdio",
      "command": "solidcraft-cli",
      "args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
    }
  }
}

Jeśli Cursor nie znajduje solidcraft-cli w PATH, podaj pełną ścieżkę do pliku binarnego. Dla Snapa: solidcraft.cli.

Narzędzia (według oficjalnej dokumentacji)

Jeszcze nie w 0.16.2: główna gałąź (main) projektu opisuje już dwie nowości, które powinny trafić do następnego wydania. Narzędzie tylko do odczytu describe_command zwraca dokumentację parametrów jednego polecenia, a jeśli polecenie ma typowany kontrakt (na razie solid.box, solid.extrude i engine.describe), także schematy JSON (JSON Schema) jego danych wejściowych i wyniku. Sesje headless zyskują też opcję --param-check off|warn|strict: off to ustawienie domyślne, warn wykonuje wywołanie, ale dołącza ostrzeżenia, np. o prawdopodobnie błędnie wpisanym kluczu, a strict odrzuca wywołanie i pozostawia projekt bez zmian. Wywołania przekazywane do uruchomionej aplikacji nie są jeszcze sprawdzane. Źródło: docs/mcp.md.

Opcjonalne umiejętności (skills) dla agentów znajdują się w katalogu skills/ w repozytorium (solidcraft-modeling, solidcraft-editing itd.).

Do jakich plików ma dostęp agent

Domyślnie narzędzia mają dostęp tylko do:

• folderu otwartego projektu (tylko jeśli leży wewnątrz folderu domowego lub tymczasowego – nie sam folder domowy i nie foldery ukryte),
• folderu odzyskiwania SolidCraft,
• prywatnego folderu roboczego na zrzuty ekranu,
• każdego folderu dodanego przez --allow-path DIR.

solidcraft-cli mcp --allow-path ~/designs --allow-path ~/exports

--allow-any-path znosi to ograniczenie (dawne zachowanie) – używaj ostrożnie.

Minimalna sesja modelowania

Schemat działania na podstawie przykładowej sesji z oficjalnej dokumentacji:

1. batch: prostokąt w szkicu → wyciągnięcie → zaokrąglenie → wycięcie otworu
2. measure: objętość / pole powierzchni
3. screenshot z view: "iso"
4. export do ścieżki wewnątrz dozwolonego folderu

Skrypty demo: examples/demo/enclosure_mcp.py buduje obudowę przez MCP.

Zobacz też: porównanie serwerów MCP dla CAD · instrukcja instalacji · przykłady.