RSAP MCP — Robot Structural Analysis ↔ Claude

RSAP MCP — Robot Structural Analysis ↔ Claude

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

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
• Xử lý sự cố / Troubleshooting
• Cấu trúc thư mục / Repository layout

Yêu cầu / Requirements

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àm2 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ếtphả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, addself-weight and a 10 kN/m roof load, run a 1.35G+1.5Q ULS combination, then tell me the basereactions 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

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

2. 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
   

3. Kiểm tra: codex mcp list.

4. 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

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

2. 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)}
   

3. Gọi hằng RobotOM bằng tên qua const("I_..."), không ghi số trực tiếp.

4. Trả về dict hoặc model Pydantic; lỗi thì raise.

5. Không dùng print(); log qua config.py.

6. 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

Modeling

Sections & Materials

Supports

Loads & Combinations

Analysis

Results

Resources

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

Xử lý sự cố / Troubleshooting

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

MIT. © 2026 PORTCOAST Taskforce.