ABB RobotStudio Server

v2.0.0 — Fork of eliasbitsch/abb-robotstudio-mcp with TcpListener transport, 55 MCP tools, AutoLoad, and security hardening.

Model Context Protocol server for ABB RobotStudio and ABB robot controllers.

Exposes 55 tools across two transports:

• rs_* (31 tools) — RobotStudio SDK via TcpListener Add-In. Inspect/edit stations, targets, paths, modules, variables, IO, configs. Drive simulation. Capture screenshots.
• rws_* (24 tools) — Robot Web Services REST API direct to controller. Motors, program control, IO, files, mastership, event log.

Tested: ABB RobotStudio 2025 + IRB 4600 Virtual Controller (IRC5).

---

✨ Improvements over original v1.0.0

Feature	Original	LiskinLabs v2.0.0
HTTP Transport	HttpListener — needs netsh http add urlacl (admin)	TcpListener — zero admin rights
Tools	50	55 (+5 new)
Add-In startup	Manual "Load Add-In" each session	AutoLoad
Screenshot	❌	✅ rs_get_screenshot
Event Log (SDK)	❌	✅ rs_get_execution_errors
Variable listing	❌	✅ rs_list_variables (type/module filter)
Bounding Box	❌	✅ rs_get_station_objects?bbox=true
IO Signals (SDK)	Stubs → "not implemented"	✅ Real API
RAPID upload	Raw UTF-8	✅ BOM-free + CRLF
Simulation reset	Stop only	✅ Stop + PP reset
Request timeout	None	✅ 15-30s AbortController
Path validation	N/A	✅ Screenshot sandboxed
CORS	N/A	✅ Removed (not a browser API)

New MCP Tools in v2.0.0

Tool	Description
rs_get_screenshot	Capture 3D view → base64 PNG (width/height params)
rs_get_execution_errors	Controller event log via SDK (count param)
rs_list_variables	RAPID variables with type/module filters
rs_get_station_objects	Now supports bbox=true for position + dimensions

---

Quick Start

1. Build

git clone https://github.com/LiskinLabs/abb-robotstudio-mcp.git
cd abb-robotstudio-mcp

# TypeScript MCP Server
cd src && npm install && npm run build && cd ..

# C# Add-In
cd addin && dotnet build ClaudeBridge.csproj && cd ..

2. Install Add-In

# As Administrator (copies to Program Files)
powershell -ExecutionPolicy Bypass -File install-addin.ps1

# Or specify RobotStudio version:
powershell -ExecutionPolicy Bypass -File install-addin.ps1 -RobotStudioVersion "2024"

3. Configure Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "abb-robotstudio": {
      "command": "node",
      "args": ["C:/path/to/abb-robotstudio-mcp/dist/index.js"],
      "env": {
        "ABB_BRIDGE_URL": "http://localhost:58080",
        "ABB_RWS_URL": "http://localhost:80",
        "ABB_RWS_USER": "Default User",
        "ABB_RWS_PASS": "robotics"
      }
    }
  }
}

4. Launch RobotStudio

1. Open a station with Virtual Controller
2. Add-In loads automatically (AutoLoad)
3. Verify: curl http://localhost:58080/ping

No admin rights needed — TcpListener binds to 127.0.0.1 natively.

---

Architecture

AI Assistant ←→ MCP stdio ←→ TypeScript Server ←→ HTTP ←→ C# Add-In (TcpListener :58080)
                                                     ←→ REST → Controller RWS (:80)

• C# Add-In (.NET 4.8): TcpListener(IPAddress.Loopback, 58080), manual HTTP parsing, 32+ endpoints, UI thread marshaling
• TypeScript (Node.js 18+): 55 MCP tools, AbortController timeouts, structured error handling

---

All 55 Tools

SDK (rs_*) — 31 tools

rs_ping rs_get_station rs_get_station_objects rs_save_station rs_get_tasks rs_get_modules rs_read_module rs_write_module rs_read_variable rs_write_variable rs_list_variables rs_get_execution_errors rs_get_screenshot rs_controller_status rs_start_simulation rs_stop_simulation rs_pause_simulation rs_reset_simulation rs_simulation_status rs_set_sim_speed rs_get_paths rs_get_path_targets rs_create_path rs_create_target rs_read_config rs_write_config rs_check_collisions rs_get_position rs_get_io_signals

RWS (rws_*) — 24 tools

rws_controller_status rws_set_motors rws_start_program rws_stop_program rws_reset_pp rws_execution_state rws_get_tasks rws_get_modules rws_read_module rws_write_module rws_read_variable rws_write_variable rws_get_position rws_get_io_signals rws_read_io rws_write_io rws_get_speed_override rws_set_speed_override rws_event_log rws_list_files rws_read_file rws_write_file rws_request_mastership rws_release_mastership

---

Environment Variables

Variable	Default	Purpose
ABB_BRIDGE_URL	http://localhost:58080	Add-In TcpListener endpoint
ABB_RWS_URL	http://localhost:80	Controller RWS (IP for real robots)
ABB_RWS_USER	Default User	RWS auth user
ABB_RWS_PASS	robotics	RWS auth password

---

Safety

⚠️ These tools can move real hardware (rws_set_motors, rws_start_program, rws_write_*). Use a virtual controller for development. Point ABB_RWS_URL at a physical robot only when you fully understand the risks.

---

Credits & Attribution

• Original author: Elias Bitsch — abb-robotstudio-mcp (MIT License). The 50-tool foundation, SDK/RWS dual-transport architecture, and ClaudeBridge Add-In concept.
• Improvements: LiskinLabs — Silvestr Liskin & Claude Code
  • TcpListener transport (eliminates admin rights requirement)
  • 5 new MCP tools (screenshot, event log, variable listing, bounding box, IO signals)
  • RAPID upload fixes (BOM-free UTF-8, CRLF normalization, module cleanup)
  • AutoLoad manifest, security hardening, request timeouts
• Inspiration: zhou-zhichao/robotstudio-mcp — pioneered the TcpListener approach for Windows permission handling.

---

License

MIT — see LICENSE