# KentraBOT MCP Server

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server for controlling a two-track robot. This server exposes tools to control motor speeds and direction, allowing LLMs to drive the robot.

## Features

-   **Movement Control**: Independent control of left and right tracks.
-   **High-Level Commands**: `drive` tool for easy direction control (forward, backward, left, right).
-   **Safety**: Emergency `stop` tool.
-   **Hardware Abstraction**: Built with a modular driver system. Currently configured with a `Dummy` driver for simulation/testing.

## Installation

### Prerequisites
-   Python 3.11 or higher
-   `uv` (recommended) or `pip`

### Setup

1.  **Clone the repository**:
    ```bash
    git clone <repository-url>
    cd kentraBOT-MCP
    ```

2.  **Install dependencies**:
    Using `uv`:
    ```bash
    uv sync
    ```
    
    Or using standard `pip`:
    ```bash
    python3 -m venv .venv
    source .venv/bin/activate
    pip install .
    ```

## Usage

### Running the Server

Start the MCP server using `uv`:

```bash
uv run kentrabot
```

Or directly with python:

```bash
python3 src/kentrabot_mcp/server.py
```

### connecting to an MCP Client

Configure your MCP client (e.g., Claude Desktop, MCP Inspector) to run the server command above.

**Example `claude_desktop_config.json`**:
```json
{
  "mcpServers": {
    "kentrabot": {
      "command": "uv",
      "args": ["run", "kentrabot"]
    }
  }
}
```

## Tools

| Tool | Description | Arguments |
|------|-------------|-----------|
| `move` | Set independent track speeds | `left_speed` (-1.0 to 1.0), `right_speed` (-1.0 to 1.0) |
| `drive` | Move in a specific direction | `direction` (forward, backward, left, right), `speed` (0.0 to 1.0) |
| `stop` | Stop both motors | None |

## Hardware Configuration

Currently, the server is set to use the `DummyRobot` driver which logs actions to the console. 

To use real hardware (e.g., Raspberry Pi with Motor Hat):
1.  Implement a new driver in `src/kentrabot_mcp/drivers/`.
2.  Inherit from `kentrabot_mcp.robot.Robot`.
3.  Update `src/kentrabot_mcp/server.py` to initialize your new driver.