Skip to main content
Glama

robot-mcp

Serveur MCP pour piloter Autodesk Robot Structural Analysis Professional depuis Claude (Claude Desktop en mode Chat, ou Claude Code), via l'API COM RobotOM.

Statut : expérimental. Écrit pour Robot 2027, pas encore testé sur toutes les versions. Vérifie toujours les résultats à la main (équilibre, ordre de grandeur, wL²/8…). L'outil supprime les erreurs d'API, pas les erreurs de modélisation.

Ce que Claude peut faire

Domaine

Outils

Projet

robot_status, robot_new_project, robot_open_project, robot_save_project

Géométrie

robot_add_nodes, robot_add_bars, robot_delete, robot_list_model

Propriétés

robot_set_section, robot_set_material, robot_set_support

Charges

robot_add_load_case, robot_add_self_weight, robot_add_nodal_force, robot_add_bar_uniform_load, robot_add_bar_point_load, robot_add_combination, robot_list_cases

Calcul

robot_calculate (enregistre automatiquement le projet, résultats inclus)

Résultats

robot_bar_forces, robot_node_reactions (avec somme pour contrôle d'équilibre), robot_node_displacements

Diagrammes

robot_export_diagrams — courbes M, V, N, flèche en PNG + CSV (Excel), avec extremums

Accès complet

robot_api_search, robot_api_describe (explorent l'API Robot réellement installée) + robot_run_python (exécute n'importe quelle commande RobotOM : relâchements, flambement, modal, neige/vent, panneaux, dimensionnement acier/BA…)

Related MCP server: midas-bridge-mcp

Projets Robot normaux, que tu reprends à la main

Claude construit un vrai modèle Robot dans la fenêtre Robot ouverte : tu le vois se construire, et tu peux le modifier toi-même à tout moment.

  • Enregistrement en .rtd : par défaut dans Documents\Robot-MCP\ (ou le chemin demandé), après création, modification et calcul.

  • Tu le rouvres dans Robot comme n'importe quel projet. Si les résultats n'apparaissent pas à la réouverture, clique sur Calculer.

  • Courbes dans Robot : Résultats > Diagrammes pour barres. Courbes exportées par Claude : dossier diagrammes\ à côté du projet.

Couverture des fonctionnalités

Les outils dédiés couvrent le flux courant (barres, charges, combinaisons, calcul, résultats, diagrammes). Tout le reste de l'API RobotOM est accessible via robot_run_python, après que Claude a cherché les noms exacts avec robot_api_search / robot_api_describe. Limite : ce que l'API COM d'Autodesk n'expose pas (certaines boîtes de dialogue ou modules) reste à faire dans l'interface de Robot.

Unités (important)

  • Entrées : m, kN, kN/m, kN·m. Le serveur convertit en N pour l'API.

  • Sorties : kN, kN·m, mm, mrad.

  • Signes : charges en repère global, Z négatif = vers le bas. Effort normal Robot FX > 0 = compression.

  • Exception : robot_run_python travaille directement en unités de l'API (N, N·m, m).

Installation (Windows)

Prérequis : Robot installé et lancé une fois ; uv (winget install --id astral-sh.uv -e) ; Git.

cd $HOME
git clone https://github.com/estebanbon8-boop/robot-mcp.git
cd robot-mcp
# Quitter Claude Desktop d'abord (icône près de l'horloge > Quitter)
powershell -ExecutionPolicy Bypass -File .\install.ps1 -WhatIf   # aperçu
powershell -ExecutionPolicy Bypass -File .\install.ps1           # installation

Le script crée un Python x64 (obligatoire : Robot est x64, même sur Windows ARM), installe le serveur, vérifie les outils, puis déclare robot-mcp dans Claude Desktop et Claude Code (avec sauvegarde *.bak-robotmcp des configs).

Déclaration manuelle (si besoin), dans claude_desktop_config.json :

{
  "mcpServers": {
    "robot-mcp": {
      "command": "C:\\Users\\<toi>\\robot-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "robot_mcp"]
    }
  }
}

Premier test

  1. Ouvre Robot.

  2. Dans Claude : « Appelle robot_status ».

  3. Puis : « Nouveau portique 2D : poutre IPE 240 en acier de 6 m sur deux appuis (rotule + appui simple), 10 kN/m vers le bas + poids propre. Calcule, donne M_max, réactions et flèche, et vérifie avec wL²/8. » Attendu : M ≈ 46,4 kN·m, R ≈ 30,9 kN, flèche ≈ 21,3 mm.

Pièges connus de Robot

  • Fermer toute boîte de dialogue dans Robot avant robot_calculate (sinon blocage).

  • Rien n'est sur disque avant robot_save_project ; après réouverture d'un fichier, relancer le calcul.

  • Un numéro de cas inexistant renvoie des zéros : vérifier avec robot_list_cases.

  • Noms de matériaux/sections = noms exacts de la base chargée dans Robot (ex. S 355, IPE 240).

  • Supprimer/recréer une barre fait perdre ses relâchements.

Licence

MIT. Projet indépendant, non affilié à Autodesk.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables users to control CSI ETABS structural engineering software through Claude, allowing model creation, status checks, and engineering checks via COM automation.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to directly control Midas Civil NX for bridge structural analysis, allowing users to model, apply loads, and perform analysis through natural language descriptions.
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to control Autodesk Robot Structural Analysis Professional via COM API for modeling, loads, analysis, and results retrieval.
      35
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to work inside Autodesk Civil 3D 2027 through natural language, reading and drawing geometry, modeling roads with alignments, profiles, assemblies, corridors and superelevation, computing earthwork volumes and mass haul, and managing styles, label sets, blocks and hatches.
      1
      MIT