What can you do with this server?

This MCP server enables AI assistants (Claude, Codex) to control Autodesk Robot Structural Analysis Professional via natural language, covering the full structural engineering workflow from model creation to results extraction. Key capabilities include: * Session & Project Management: Connect to or launch Robot, check status, create new projects (2D/3D frames, trusses, shells, plates, grillages), open, save, and close .rtd files. * Structural Modeling: Add individual or bulk nodes and bars, list and delete objects using Robot selection strings (e.g., '1to10'), and manage geometry. * Sections & Materials: Define sections from profile databases (IPE, HEA, etc.) and materials from built-in or custom elastic properties, assign to bars, and list defined sections. * Boundary Conditions: Define pinned, fixed, roller, or custom supports with full translational and rotational restraint control, and assign to nodes. * Loads & Combinations: Create load cases with nature and analysis type, add self-weight, nodal forces/moments, uniform and point loads on bars, and define load combinations (ULS/SLS) with custom factors. * Analysis: Generate FE mesh for shell/plate models, run structural analysis, and check calculation status. * Results Extraction: Retrieve bar internal forces (axial, shear, bending, torsion) at points or as envelopes, nodal displacements, support reactions, and a results summary (peak displacement, peak moment) per load case.

Which integrations are available for this server?

Provides tools for interacting with Autodesk Robot Structural Analysis Professional, enabling AI agents to create structural models, apply loads, run analyses, and retrieve results via the RobotOM COM API.

How do I use RSAP MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@RSAP MCP Build a 6x4m portal frame in S235, fix bases, add 10 kN/m roof load, analyze, get reactions." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

RSAP MCP

by nhantruong96

Overview Schema Related Servers Score Discussions

Python

Local

RSAP MCP — Robot Structural Analysis ↔ Claude

MCP server cho Autodesk Robot Structural Analysis Professional 2027 — dùng với Claude hoặc Codex.

Mục lục / Contents

Related MCP server: Civil3D MCP Server

Yêu cầu / Requirements


OS	Windows 10/11 (64-bit)
Robot	Robot Structural Analysis Professional 2027, đã cài & mở ít nhất một lần
Python	3.10+, 64-bit
uv	`powershell -c "irm https://astral.sh/uv/install.ps1 \| iex"`
Host	Claude Desktop hoặc Codex

Bước 1 — Cài đặt / Install

git clone https://github.com/nhantruong96/rsap-mcp.git
cd rsap-mcp
uv sync

Chạy lại uv sync sau mỗi git pull.

Kiểm tra (không cần Robot):

uv run python -m rsap_mcp --selfcheck
# -> [selfcheck] 35 tools registered ... OK

Tùy chọn thêm / optional extras:

uv sync --extra dev     # + ruff

Tùy chọn — chép .env.example thành .env rồi sửa RSAP_VISIBLE, RSAP_INTERACTIVE, RSAP_AUTO_CONNECT, RSAP_LOG_LEVEL, RSAP_LOG_FILE, RSAP_PROJECT_DIR.

Không có uv:

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

Bước 2 — Đăng ký với Claude Desktop / Register with Claude Desktop

powershell -ExecutionPolicy Bypass -File .\scripts\register_claude_desktop.ps1

Hoặc sửa tay %APPDATA%\Claude\claude_desktop_config.json: chép một trong hai khối dưới đây, thay C:\path\to\rsap-mcp bằng đường dẫn thật (mẫu: config/claude_desktop_config.example.json).

A. Qua uv — khuyến nghị:

{
  "mcpServers": {
    "rsap": {
      "command": "uv",
      "args": ["--directory", "C:/path/to/rsap-mcp", "run", "rsap-mcp"]
    }
  }
}

B. Trỏ thẳng Python của venv — khi uv không có trong PATH của Claude Desktop:

{
  "mcpServers": {
    "rsap": {
      "command": "C:\\path\\to\\rsap-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "rsap_mcp"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\rsap-mcp\\src",
        "RSAP_VISIBLE": "true",
        "RSAP_LOG_LEVEL": "INFO"
      }
    }
  }
}

Sau khi sửa: thoát hẳn rồi mở lại Claude Desktop. Log: %APPDATA%\Claude\logs\mcp-server-rsap.log.

Bước 3 — Dùng thử / First run

Mở Claude Desktop và ra lệnh bằng lời:

"Kết nối Robot, tạo dự án khung 2D, dựng khung cổng nhịp 6 m cao 4 m bằng thép S235 IPE300, ngàm 2 chân, thêm trọng lượng bản thân và tải mái 10 kN/m, chạy tổ hợp ULS 1.35×TT+1.5×HT rồi cho biết phản lực chân cột và mô men lớn nhất ở xà."

"Connect to Robot, make a 2D frame, build a 6×4 m portal in S235 IPE300, fix both bases, add self-weight and a 10 kN/m roof load, run a 1.35G+1.5Q ULS combination, then tell me the base reactions and peak rafter moment."

Trình tự chuẩn / the workflow:

connect → new_project → add_nodes → add_bars → define_section/material → assign →
define_support → assign_support → add_load_case → add_*_load → add_combination →
calculate → bar_forces / node_displacement / node_reaction → save_project

Đơn vị: m, N, N·m.
Chuỗi chọn đối tượng: '1to10', '1 2 3', '1to20by2'.
Chờ lâu ở tool đầu tiên — Robot đang mở.

Dùng với Codex / Use with Codex

Mở C:\Users\<YOU>\.codex\config.toml (macOS/Linux: ~/.codex/config.toml).

Thêm khối sau, sửa đường dẫn (mẫu: config/codex_config.example.toml):

[mcp_servers.rsap]
enabled = true
command = 'C:\path\to\rsap-mcp\.venv\Scripts\python.exe'
args = ["-m", "rsap_mcp"]
startup_timeout_sec = 30
tool_timeout_sec = 600                      # rsap_calculate chạy lâu
default_tools_approval_mode = "prompt"      # "auto" nếu không muốn hỏi từng tool

[mcp_servers.rsap.env]
RSAP_VISIBLE = "true"
RSAP_INTERACTIVE = "true"
RSAP_AUTO_CONNECT = "true"
RSAP_LOG_LEVEL = "INFO"

Hoặc thêm bằng một dòng lệnh / or add it with the CLI:

codex mcp add rsap --env RSAP_VISIBLE=true --env RSAP_AUTO_CONNECT=true -- `
  "C:\path\to\rsap-mcp\.venv\Scripts\python.exe" -m rsap_mcp

Kiểm tra: codex mcp list.
Thoát hẳn và mở lại app Codex, gõ /mcp để thấy rsap và 35 tools.

Giới hạn tool: thêm enabled_tools = [...] hoặc disabled_tools = [...] vào khối [mcp_servers.rsap].

Kiểm thử bằng client rời / Test with the standalone client

uv run python client\test_client.py                # liệt kê tool qua MCP thật
uv run python client\test_client.py --call rsap_status
uv run python client\examples\01_portal_frame.py   # end-to-end (cần Robot)
uv run ruff check .                                # lint

Thêm công cụ mới / Add a new tool

Mở module phù hợp trong src/rsap_mcp/tools/ (project_, modeling_, property_, support_, load_, analysis_, results_tools.py).

Viết hàm bên trong register(mcp), gắn @mcp.tool() rồi @com_call, kèm type hints và docstring Google-style:

def register(mcp):
    @mcp.tool()
    @com_call
    def rsap_count_objects() -> dict:
        """Return node and bar counts."""
        c = conn()
        return {"nodes": c.count(c.nodes), "bars": c.count(c.bars)}

Gọi hằng RobotOM bằng tên qua const("I_..."), không ghi số trực tiếp.
Trả về dict hoặc model Pydantic; lỗi thì raise.
Không dùng print(); log qua config.py.
Chạy uv run python -m rsap_mcp --selfcheck và uv run ruff check ..

Danh sách công cụ / Tool list

35 tool (tiền tố rsap_) và 3 resource. Dấu * = tham số bắt buộc.

Session & Project

Tool	Mô tả / Description	Tham số / Parameters
`rsap_connect`	Connect to (or launch) Autodesk Robot Structural Analysis Professional.	`visible`:boolean, `interactive`:boolean
`rsap_status`	Report connection status and a summary of the current Robot model.	(none)
`rsap_new_project`	Create a new, empty Robot project.	`project_type`:string
`rsap_open_project`	Open an existing Robot model from an absolute .rtd path.	`path`:string `*`
`rsap_save_project`	Save the current model. Pass a path to Save As, or omit to Save in place.	`path`:string/null
`rsap_close_project`	Close the current project (Robot itself stays open).	(none)

Modeling

Tool	Mô tả / Description	Tham số / Parameters
`rsap_add_node`	Create a single node at the given coordinates (metres).	`x`:number ``, `y`:number ``, `z`:number `*`, `number`:integer/null
`rsap_add_nodes`	Create many nodes at once.	`nodes`:array `*`
`rsap_add_bar`	Create a bar (beam/column) between two existing nodes, optionally assigning section/material.	`start_node`:integer ``, `end_node`:integer ``, `number`:integer/null, `section`:string/null, `material`:string/null
`rsap_add_bars`	Create many bars at once.	`bars`:array `*`
`rsap_list_nodes`	List nodes with their coordinates.	`limit`:integer
`rsap_list_bars`	List bars with their start/end node numbers.	`limit`:integer
`rsap_delete_objects`	Delete nodes or bars matching a selection string.	`object_type`:string ``, `selection`:string ``

Sections & Materials

Tool	Mô tả / Description	Tham số / Parameters
`rsap_define_section`	Define a bar section label by loading a profile from Robot's active database.	`name`:string `*`, `db_section`:string/null, `material`:string/null
`rsap_define_material`	Define a material label, either loaded from Robot's material database or from explicit properties.	`name`:string `*`, `from_database`:string/null, `material_type`:string/null, `e`:number/null, `nu`:number/null, `ro`:number/null, `kirchoff`:number/null
`rsap_assign_section`	Assign an existing section label to a set of bars.	`section_name`:string ``, `bars`:string ``
`rsap_assign_material`	Assign an existing material label to a set of bars.	`material_name`:string ``, `bars`:string ``
`rsap_list_sections`	List the names of section labels defined in the model.	(none)

Supports

Tool	Mô tả / Description	Tham số / Parameters
`rsap_define_support`	Define a support (boundary condition) label. True = restrained.	`name`:string `*`, `ux`:boolean, `uy`:boolean, `uz`:boolean, `rx`:boolean, `ry`:boolean, `rz`:boolean
`rsap_assign_support`	Assign an existing support label to a set of nodes.	`support_name`:string ``, `nodes`:string ``

Loads & Combinations

Tool	Mô tả / Description	Tham số / Parameters
`rsap_add_load_case`	Create a simple load case.	`name`:string `*`, `nature`:string, `analysis`:string, `number`:integer/null
`rsap_add_self_weight`	Add a self-weight (dead) load to a case.	`case_number`:integer `*`, `direction`:string, `factor`:number, `selection`:string
`rsap_add_nodal_force`	Add a nodal force/moment to a case (global axes).	`case_number`:integer ``, `nodes`:string ``, `fx`:number, `fy`:number, `fz`:number, `cx`:number, `cy`:number, `cz`:number
`rsap_add_bar_uniform_load`	Add a uniformly distributed load along bars.	`case_number`:integer ``, `bars`:string ``, `px`:number, `py`:number, `pz`:number, `local`:boolean, `projected`:boolean
`rsap_add_bar_point_load`	Add a concentrated (point) force/moment on bars.	`case_number`:integer ``, `bars`:string ``, `fx`:number, `fy`:number, `fz`:number, `cx`:number, `cy`:number, `cz`:number, `position`:number, `relative`:boolean, `local`:boolean
`rsap_add_combination`	Create a load combination from weighted load cases.	`name`:string ``, `factors`:array ``, `combo_type`:string, `nature`:string, `number`:integer/null
`rsap_list_load_cases`	List load cases and combinations in the model.	(none)

Analysis

Tool	Mô tả / Description	Tham số / Parameters
`rsap_generate_mesh`	Generate the finite-element mesh.	(none)
`rsap_calculate`	Run the structural analysis (solve the model).	(none)
`rsap_calculation_status`	Report whether analysis results are currently available.	(none)

Results

Tool	Mô tả / Description	Tham số / Parameters
`rsap_bar_forces`	Internal forces at a point along a bar (local axes).	`bar`:integer ``, `case`:integer ``, `position`:number
`rsap_bar_force_envelope`	Sample a bar along its length and return the extreme internal forces.	`bar`:integer ``, `case`:integer ``, `samples`:integer
`rsap_node_displacement`	Nodal displacement (global axes).	`node`:integer ``, `case`:integer ``
`rsap_node_reaction`	Support reaction at a node (global axes).	`node`:integer ``, `case`:integer ``
`rsap_results_summary`	Summarise results for a case: peak nodal displacement and peak bar moment.	`case`:integer `*`, `max_nodes`:integer, `max_bars`:integer

Resources

URI	Nội dung / Content
`rsap://reference/enums`	Bản đồ friendly → hằng RobotOM.
`rsap://reference/sections`	Hướng dẫn tiết diện & vật liệu.
`rsap://reference/cheatsheet`	Quy trình end-to-end.

Tham chiếu RobotOM COM API để mở rộng server: docs/RobotOM_API_Reference.md.

Xử lý sự cố / Troubleshooting

Triệu chứng / Symptom	Xử lý / Fix
Server không hiện trong Claude	Kiểm tra `command`/`PYTHONPATH`, khởi động lại Claude, xem `mcp-server-rsap.log`.
`/mcp` trong Codex không thấy `rsap`	Thoát hẳn & mở lại Codex; chạy `codex mcp list`; kiểm tra `command` trong `config.toml`.
`constant 'I_...' not found`	Mở Robot một lần để đăng ký type library; đối chiếu tên hằng trong `enums.py`.
Kết nối COM thất bại	Dùng Python 64-bit; kiểm tra Robot đã cài đúng bitness.
Giao thức hỏng ngay khi khởi động	Tìm thư viện đang in ra stdout; chuyển log sang stderr/file.
`ModuleNotFoundError: mcp.server.fastmcp`	Đang dùng `mcp` 2.x; gói đã ghim `mcp[cli]<2` — chạy lại `uv sync`.
`ModuleNotFoundError: mcp` khi chạy client	Chạy qua venv: `uv run python client\...`.
`Could not read results`	Chạy `rsap_calculate()` trước; kiểm tra số bar/node/case có tồn tại.
`LoadFromDBase` lỗi	Đặt đúng CSDL tiết diện/vật liệu trong Job Preferences (IPE300 cần catalog châu Âu).
Treo khi Calculate	Đóng hộp thoại đang chờ trong cửa sổ Robot.
Tool đầu tiên rất chậm / timeout	Robot đang khởi động — tăng `tool_timeout_sec` hoặc mở Robot sẵn.
Model gọi tool sai thứ tự	Nhắc trong prompt "làm tuần tự theo cheatsheet".

Cấu trúc thư mục / Repository layout

rsap-mcp/
├── src/rsap_mcp/          # MCP server (server.py, robot_app.py, com_utils.py,
│   │                      #   enums.py, config.py)
│   ├── tools/             # 35 tool rsap_* theo nhóm
│   ├── models/            # pydantic schemas
│   └── resources/         # rsap://reference/*
├── client/                # client MCP rời + examples
├── scripts/               # install / run / register (PowerShell)
├── config/                # claude_desktop_config.example.json, codex_config.example.toml
├── native/RsapHelper/     # DLL C# tùy chọn
├── docs/                  # RobotOM_API_Reference.md
├── pyproject.toml
└── uv.lock                # `uv sync` đọc file này

License

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

AutoCAD MCP Server
Developer Tools App Automation Software Architecture
Porta048
A
license
-
quality
D
maintenance
Enables users to control AutoCAD, GstarCAD, or ZWCAD through natural language via Claude Desktop. It provides tools for drawing geometric shapes, adding text and dimensions, and managing CAD files using the Windows COM interface.
Last updated 2026-01-20
2
MIT
Civil3D MCP Server
antonhofstader
A
license
-
quality
D
maintenance
Connects Claude to a running Autodesk Civil 3D instance via COM automation to perform drawing, surface, alignment, COGO point, line, and corridor operations.
Last updated 2026-04-08
7
MIT
FreeCAD MCP
Design Tools Code Execution
Yaeshio
A
license
A
quality
B
maintenance
Enables Claude Desktop to control FreeCAD for 3D CAD modeling, including creating, editing, and deleting objects, executing Python code, and running FEM analyses.
Last updated 2026-06-07
14
MIT
AutoCAD MCP Server
Design Tools
thepiruthvirajan
A
license
-
quality
D
maintenance
Enables programmatic control of AutoCAD through COM automation, allowing natural language commands to create structures, manage layers, and manipulate entities via MCP clients like Claude.
Last updated 2025-07-28
54
Apache 2.0

View all related MCP servers

Related MCP Connectors

AgentSEO
Live SEO workflow tools for Claude Code, Codex, and AI agents.
Garmin — MissingMCP
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
Bullrun
Global stock research, ML forecasts, valuation signals, screeners & portfolio tracking in Claude

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nhantruong96/rsap-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

RSAP MCP — Robot Structural Analysis ↔ Claude

Mục lục / Contents

Yêu cầu / Requirements

Bước 1 — Cài đặt / Install

Bước 2 — Đăng ký với Claude Desktop / Register with Claude Desktop

Bước 3 — Dùng thử / First run

Dùng với Codex / Use with Codex

Kiểm thử bằng client rời / Test with the standalone client

Thêm công cụ mới / Add a new tool

Danh sách công cụ / Tool list

Session & Project

Modeling

Sections & Materials

Supports

Loads & Combinations

Analysis

Results

Resources

Xử lý sự cố / Troubleshooting

Cấu trúc thư mục / Repository layout

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

AutoCAD MCP Server

Civil3D MCP Server

FreeCAD MCP

AutoCAD MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API