Startpagina / MCP-handleiding

SolidCraft draaien met MCP (Claude, Codex & Cursor)

De primaire bron:docs/mcp.md voor / Officiële MCP gidsOfficiële klant voorbeelden dekkingvan Claude Codeenvan Claude DesktopCodex en Cursor gebruiken de standaard MCP stdio config vanOpenAI's Codex MCP-documentenenCursor's MCP documentenmet dezelfde opdracht.

Wat doet de MCP server

solidcraft-cli mcpAgenten voeren dezelfde motorcommandes uit als de werkbalk, scripts en CLI - schetsen maken, functies maken, parameters instellen, meten, screenshotten maken, STEP/STL exporteren, undo/redo maken - zonder dialogen te openen.

• Zonder hoofd:in-process design sessie (screenshots op GPU / software / CPU fallback).
• van Bridget:vanaf 0.21.0 — en nog steeds in 0.22.0 — het besturingskanaal en de MCP zijndoor defaultzijn127.0.0.1:27878(of de volgende vrije poort tot 27893). Schakel ze uit in Preferences › Assistant › "Let AI agents connect (control channel / MCP)" als u dat wilt.

Begin het

# Headless
solidcraft-cli mcp

# Headless from a design or script
solidcraft-cli mcp --in part.solidcraft

# Bridged: app listens by default — bare mcp finds it (headless when none runs; --headless forces that)
solidcraft &
solidcraft-cli mcp

# Fixed port / second app
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878

Snap installeert de CLIsolidcraft.cliDe app schrijft de gekozen poort naarcontrol/current.portin zijn gegevensbestand;--control / SOLIDCRAFT_CONTROL_PORTnog steeds overslaan.

AppImage, Snap of Flatpak? solidcraft-cli voor MCP krijgen

De meeste pakketten zetten solidcraft-cli na installatie op het PATH (Windows-installatiemap; deb/rpm/FreeBSD in /usr/bin; Homebrew-cask; AppImage schrijft bij de eerste run een kleine launcher naar ~/.local/bin; de macOS-app koppelt naar /opt/homebrew/bin of /usr/local/bin). Twee blijven expres buiten het PATH: Snap biedt solidcraft.cli, Flatpak draait flatpak run --command=solidcraft-cli ai.storyteller.solidcraft — gebruik dat als command van de client met mcp als args. Het AppImage-entry point blijft de GUI; solidcraft-cli uit de squashfs extraheren blijft een geldig alternatief. Geverifieerde stappen en clientconfigs:

Gids: AppImage-CLI & MCP →

van Claude Code

Uit het officiële MCP doc:

claude mcp add solidcraft -- solidcraft-cli mcp

of project.mcp.json:

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

Claude Desktop (gebroken)

Met control channel en MCP standaard aan (0.21.0+, opnieuw in 0.22.0) start je de app gewoon en wijs je Claude Desktop naar een kaal mcp (hij vindt de draaiende app). Na een normale pakketinstallatie staat solidcraft-cli meestal op het PATH (Windows-installatiemap; deb/rpm/FreeBSD; Homebrew; AppImage-launcher in ~/.local/bin na de eerste run; macOS-appkoppeling) — herstart de client zodat hij het nieuwe PATH oppikt. Voor Snap: solidcraft.cli; voor Flatpak: flatpak met args run --command=solidcraft-cli ai.storyteller.solidcraft mcp (of zet command/args). Het officiële vaste-poortvoorbeeld voor claude_desktop_config.json werkt nog steeds als je een poort noemt:

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

Voor een vaste haven:args: ["mcp", "--connect", "127.0.0.1:7878"]Start de app metsolidcraft --control 7878.

Codex (CLI, IDE extensie, desktop app)

Voeg de hoofdloze server toe met één opdracht:

codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list     # check it is registered

Of Edit~/.codex/config.tomlhandmatig, bijvoorbeeld om te bruggen naar een lopende app en een map ontwerpen toe te staan:

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

In de terminal-UI van Codex toont /mcp de actieve servers. Staat solidcraft-cli niet op PATH, gebruik dan het volledige pad naar de binary (Snap: solidcraft.cli; Flatpak: flatpak run --command=solidcraft-cli ai.storyteller.solidcraft; AppImage: launcher na de eerste run in ~/.local/bin, of zie waar de CLI staat). Apart kan het Agent chat-paneel in de app Codex draaien via npm install -g @agentclientprotocol/codex-acp (officiële docs).

cursor

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

Gebruik het volledige pad naar de binary als Cursor solidcraft-cli niet op PATH vindt. Voor Snap: solidcraft.cli. Voor Flatpak: flatpak met run --command=solidcraft-cli ai.storyteller.solidcraft mcp.

Tools (van officiële docs)

Langlopende verzoeken (bridged ) :de server kan tot ongeveer 300 s blokkeren op een langzame besturingsoproep; stel de MCP-client-timeout hoger dan 330 s. Als een oproep uitvalt of "nog loopt" retourneert, verzend dezelfde wijziging niet opnieuw - oproeppendingen/ofrunning(ofinspect_design) eerst

Controleer de parameters (sinds 0.17.0):bestellingen met een getypt contract (tot nu toesolid.box, solid.extrudeenengine.describe) kunnen worden gecontroleerd wanneer ze worden geroepen, endescribe_commandtoont hun schema's. Start een hoofdloze sessie met--param-check off|warn|strict: offis de default en verandert niets,warnde oproep uitvoert, maar voegt waarschuwingen toe, zoals een waarschijnlijk verkeerde sleutel, enstrictweigert de oproep en laat het ontwerp intact. oproepen die worden doorgestuurd naar een lopende app worden nog niet gecontroleerd.joint.inspectdoorexecuteDe bron:docs/mcp.md bij v0.17.0.

Optionele agent vaardigheden leven onderskills/in de repo (solidcraft-modeling, solidcraft-editingenzovoort). de MCPskill_referencetool (sinds 0.21.0) retourneert die gebundelde docs zonder dat er toegang tot de schijf nodig is; docs documenteren ook de gebundeldependingtool (19 tools totaal met undo/redo afzonderlijk geteld; ongewijzigd in 0.22.0).

Welke bestanden kan de agent bereiken

Standaard worden tools alleen aangeraakt:

• de map van het open ontwerp (alleen als strikt binnen uw huis of temp, niet thuis zelf, geen verborgen mappen),
• De herstelmap van SolidCraft,
• een privé-scratchmap voor screenshots,
• Iedere--allow-path DIRU voegt toe.

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

--allow-any-pathverwijdert de limiet (voorgaand gedrag) – gebruik het voorzichtig.

Minimale modellen sessie

Conceptuele stroom uit de voorbeeldsessie van de officiële doc:

1. batcheen schets rechthoek → extrudeer → filet → snij een gat
2. measureVolume / gebied
3. screenshotmetview: "iso"
4. exportnaar een pad binnen een toegestane map

Demo scripts voor:voorbeelden/demo/enclosure_mcp.pyBouw een omhulsel over MCP.

Zie ook:CAD MCP servers vergeleken · Installeer gids · Voorbeelden.