# RoboDK MCP Server
A Model Context Protocol (MCP) server for RoboDK. Allows AI agents to control RoboDK sessions, manage stations, add robots, and inspect the station tree.
## Installation
This project uses `uv`.
```bash
uv sync
```
## Running the Server
Run the server using `uv`:
```bash
uv run robodk-mcp
```
This starts the server using `stdio` transport. It is designed to be used by an MCP client (like Claude Desktop or an IDE).
## Tools
### `robodk.start`
Launches RoboDK or connects to an existing instance.
- **Returns**: Session ID.
### `robodk.open_station`
Opens a station file or creates a new empty station.
- **Arguments**:
- `empty` (boolean): If true, creates a new empty station.
- `file_path` (string): Path to `.rdk` file to open.
### `station.add_robot`
Adds a robot to the current station.
- **Arguments**:
- `robot_model` (string): Name or path of the robot (e.g., "UR10", "KUKA KR 6 R900").
- **Returns**: Robot ID and Name.
- **Note**: Requires the robot file to be available locally or in RoboDK's library.
## Resources
### `station://current/tree`
Returns the current station hierarchy as a JSON tree.
- **Fields**: `id`, `name`, `type`, `parent`.
## Development
- **Build**: `uv build`
- **Verify**: `python verify_mcp.py`