KentraBOT MCP Server

An MCP (Model Context Protocol) 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:

   git clone <repository-url>
   cd kentraBOT-MCP
   

2. Install dependencies: Using uv:

   uv sync
   

   Or using standard pip:

   python3 -m venv .venv
   source .venv/bin/activate
   pip install .
   

Usage

Running the Server

Start the MCP server using uv:

uv run kentrabot

Or directly with python:

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:

{
  "mcpServers": {
    "kentrabot": {
      "command": "uv",
      "args": ["run", "kentrabot"]
    }
  }
}

Tools

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.