Ligne de commande et MCP

Tout ce que vous faites dans BIMopen est une commande. Un clic sur Mur et deux points dans le plan exécutent la même commande wall que vous pouvez taper vous-même. Ce chapitre décrit la ligne de commande de la fenêtre, le programme bimopen-cli, qui exécute les mêmes commandes sans fenêtre, et le serveur MCP, grâce auquel un agent d'IA peut modéliser, vérifier et rendre un projet.

La ligne de commande de la fenêtre

La ligne de commande se trouve sous la zone de dessin. Sa partie supérieure est le journal ; sa dernière ligne est l'endroit où vous tapez.

• Vous n'avez pas besoin de cliquer dessus au préalable : tout ce que vous tapez lorsqu'aucun autre champ n'est en cours de modification y va.
• Enter exécute la ligne. La commande est reprise dans le journal après un >, suivie de son résultat ; une erreur s'affiche en rouge et ne change rien.
• Up et Down rappellent les lignes tapées auparavant.
• À gauche de la ligne, l'invite indique ce qui est attendu : Command: lorsqu'aucun outil n'est actif, ou la demande de l'outil actif, comme WALL next point [Esc to finish]:.
• help répertorie toutes les commandes avec une ligne de description ; help wall affiche le mode d'emploi de l'une d'elles. ? ▸ Commandes dans la barre de titre fait la même chose que help.

Les raccourcis saisis lancent les outils

Une commande tapée sans arguments lance l'outil interactif, comme si vous cliquiez sur son bouton : WA (ou wall) lance l'outil de mur, DR l'outil de porte, VG ouvre Visibilité/Graphismes. La même commande avec des arguments effectue le travail immédiatement, sans l'outil : wall 0,0 5,0 dessine un mur de l'origine jusqu'à 5 m le long de x.

Les noms des commandes, leurs formes courtes et leurs arguments sont les mêmes dans toutes les langues de l'interface ; la plupart acceptent aussi un nom italien, comme muro pour wall. Les noms de paramètres, de types et de vues suivent la langue de l'interface : en anglais, vous tapez set Unconnected Height 2.7m, en italien set Altezza non collegata 2.7m. Le chapitre sur les raccourcis clavier répertorie toutes les formes courtes.

Points et longueurs

Par exemple, wall 0,0 @6,0 @4<90 0,4 c dessine un rectangle de 6 × 4 m ; le c final le ferme.

Arguments en JSON

Chaque commande accepte aussi ses arguments sous forme d'objet JSON, qui donne accès à toutes ses options. La ligne de mode d'emploi de help les répertorie :

wall 0,0 10,0 {"height":3.2,"location":"Linea d'asse del muro"}
roof walls {"slope":30,"overhang":0.5}
sheet A102 Plans {"title_block":"A3"}
export doors.csv {"schedule":"doors"}

Commandes d'usage courant

Chaque élément possède un numéro, son identifiant, affiché entre parenthèses après sa création : Door «Single swing door 80x210» in wall 102 (106). Les commandes l'acceptent là où elles ont besoin d'un élément : params 106, delete 106.

bimopen-cli

bimopen-cli exécute BIMopen sans fenêtre : pour convertir des fichiers, construire un projet à partir d'un script, vérifier un modèle, ou servir des agents via MCP. Compilez-le avec cargo build --release -p bimopen-cli.

bimopen-cli info <file>
bimopen-cli convert <in> <out> [--level NAME] [--view 3d] [--schedule walls|doors|windows|floors|rooms|materials]
bimopen-cli run [<file> | --sample] [--cmd LINE]… [--script FILE] [--save FILE] [--export FILE]…
bimopen-cli commands
bimopen-cli mcp [<file> | --sample]

Les messages sont dans la langue de la variable d'environnement BIMOPEN_LANG (it, en, de, fr, es, ar), ou du système (LANG), ou en italien. bimopen-cli se termine avec le code 0 lorsque tout a fonctionné, 1 lorsqu'une commande a échoué (le message indique laquelle), et 2 lorsque les arguments sont erronés (il affiche le mode d'emploi).

export BIMOPEN_LANG=en
bimopen-cli run --script house.txt --save house.bimopen --export house.ifc
bimopen-cli convert house.bimopen plan.svg
bimopen-cli convert house.bimopen doors.csv --schedule doors
bimopen-cli convert house.bimopen first.png --level "First Floor"
bimopen-cli convert house.bimopen house-3d.png --view 3d
bimopen-cli convert project.rvt project.bimopen

Un script est un fichier texte contenant une commande par ligne, exactement comme on la tape dans la ligne de commande :

# a small house
wall 0,0 10,0 10,6 0,6 c
door 5,0
window 10,3
floor walls
roof walls

Les nomenclatures sont écrites en CSV avec ; entre les colonnes, les en-têtes dans la langue des messages et une ligne de total à la fin.

MCP : BIMopen pour les agents d'IA

Le Model Context Protocol (MCP) permet à un agent d'IA d'utiliser des programmes comme outils. bimopen-cli mcp est un serveur MCP : il communique en JSON-RPC 2.0 sur l'entrée et la sortie standard, un message par ligne, et garde un projet ouvert pendant toute la conversation. Sans fichier, il démarre à partir d'un nouveau projet ; --sample démarre à partir de la maison d'exemple.

Pour l'ajouter à un agent, indiquez à l'agent la commande à lancer. Par exemple, dans Claude Code :

claude mcp add bimopen -- bimopen-cli mcp --sample

ou, dans un client configuré en JSON :

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

Le serveur propose sept outils :

Les réponses contiennent le message de la commande et, lorsqu'il y en a, ses données en JSON, comme les identifiants des éléments créés. Un agent peut vérifier son propre travail en demandant un rendu.