Accueil / Tutoriel MCP

Piloter SolidCraft avec MCP (Claude, Codex et Cursor)

Source principale : docs/mcp.md / guide MCP officiel. Les exemples de clients officiels couvrent Claude Code et Claude Desktop. Codex et Cursor utilisent la configuration MCP stdio standard, d’après la documentation MCP de Codex (OpenAI) et la documentation MCP de Cursor, avec la même commande.

Ce que fait le serveur MCP

solidcraft-cli mcp est un serveur Model Context Protocol sur stdio. Les agents exécutent les mêmes commandes du moteur que la barre d’outils, les scripts et la CLI – créer des esquisses et des fonctions, définir des paramètres, mesurer, faire des captures, exporter en STEP/STL, annuler/rétablir – sans ouvrir de boîte de dialogue.

• Sans interface (headless) : session de conception dans le processus (captures via GPU, ou repli logiciel / CPU).
• Mode pont (bridged) : pilote une application de bureau en cours d’exécution, lancée avec solidcraft --control PORT, pour que vous puissiez suivre les opérations.

Le démarrer

# Sans interface
solidcraft-cli mcp

# Sans interface, à partir d’une conception ou d’un script
solidcraft-cli mcp --in part.solidcraft

# En pont avec l’application en cours d’exécution
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878

Avec une installation Snap, la CLI s’appelle solidcraft.cli.

Vous utilisez l’AppImage ou Snap ? Obtenir solidcraft-cli pour MCP

L’AppImage Linux lance le binaire de l’interface graphique (solidcraft). Elle n’expose pas mcp en tant que CLI. Le serveur MCP se trouve sous le nom solidcraft-cli à l’intérieur du squashfs de l’AppImage : extrayez-le, ou utilisez le .tar.gz/.deb, qui contiennent les deux outils. Étapes vérifiées, tableau des paquets et configurations avec chemins absolus pour Claude Code / Desktop / Cursor :

Guide CLI AppImage et MCP →

Claude Code

D’après la documentation MCP officielle :

claude mcp add solidcraft -- solidcraft-cli mcp

Ou dans le fichier .mcp.json du projet :

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

Claude Desktop (mode pont)

Exemple officiel pour claude_desktop_config.json :

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

Lancez d’abord l’application avec solidcraft --control 7878.

Codex (CLI, extension IDE, application de bureau)

Ajoutez le serveur sans interface en une seule commande :

codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list     # vérifier qu’il est bien enregistré

Ou modifiez ~/.codex/config.toml à la main, par exemple pour vous connecter en pont à une application en cours d’exécution et autoriser un dossier de conceptions :

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

Dans l’interface terminal de Codex, /mcp affiche les serveurs actifs. Indiquez le chemin complet du binaire si solidcraft-cli n’est pas dans le PATH (Snap : solidcraft.cli ; utilisateurs de l’AppImage : voir où se trouve la CLI). Par ailleurs, le panneau « Chat de l’agent » (Agent chat) intégré à SolidCraft peut exécuter Codex via npm install -g @agentclientprotocol/codex-acp (documentation officielle).

Cursor

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

Indiquez le chemin complet du binaire si Cursor ne trouve pas solidcraft-cli dans le PATH. Pour Snap : solidcraft.cli.

Outils (d’après la documentation officielle)

Pas encore dans la 0.16.2 : la branche principale (main) du projet documente déjà deux ajouts qui devraient arriver avec la prochaine version. Un outil en lecture seule, describe_command, renvoie la documentation des paramètres d’une commande et, lorsqu’une commande possède un contrat typé (pour l’instant solid.box, solid.extrude et engine.describe), des schémas JSON (JSON Schema) pour ses entrées et son résultat. Les sessions sans interface gagnent aussi --param-check off|warn|strict : off est la valeur par défaut, warn exécute l’appel mais y joint des avertissements, par exemple pour une clé probablement mal orthographiée, et strict rejette l’appel et laisse la conception intacte. Les appels transmis à l’application en cours d’exécution ne sont pas encore vérifiés. Source : docs/mcp.md.

Des compétences (skills) optionnelles pour agents se trouvent sous skills/ dans le dépôt (solidcraft-modeling, solidcraft-editing, etc.).

À quels fichiers l’agent a-t-il accès ?

Par défaut, les outils n’accèdent qu’à :

• le dossier de la conception ouverte (uniquement s’il se trouve strictement à l’intérieur de votre dossier personnel ou du dossier temporaire, ni le dossier personnel lui-même, ni un dossier caché),
• le dossier de récupération de SolidCraft,
• un dossier de travail privé pour les captures,
• chaque dossier ajouté avec --allow-path DIR.

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

--allow-any-path supprime cette limite (ancien comportement) : à utiliser avec prudence.

Session de modélisation minimale

Déroulé de principe, d’après l’exemple de session de la documentation officielle :

1. batch : rectangle d’esquisse → extrusion → congé → perçage d’un trou
2. measure : volume / aire
3. screenshot avec view: "iso"
4. export vers un chemin situé dans un dossier autorisé

Scripts de démo : examples/demo/enclosure_mcp.py construit un boîtier via MCP.

Voir aussi : comparatif des serveurs MCP pour la CAO · guide d’installation · exemples.