# 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`