KentraBOT

Provides MCP-driven control of left and right tracks with high-level drive commands, safety stop, and modular driver support for simulation or real hardware.

python

0

GitHub Stars

python

Language

2 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kentra-kentrabot-mcp": {
      "command": "python3",
      "args": [
        "src/kentrabot_mcp/server.py"
      ]
    }
  }
}

You can use the KentraBOT MCP Server to control a two-track robot through the MCP (Model Context Protocol). It exposes precise motor control for each track, plus high-level movement commands and a safety stop, enabling autonomous or assisted navigation with confidence.

How to use

Connect your MCP client to the server using one of the available local runtimes or a remote endpoint. You will be able to issue commands to drive the left and right tracks independently, or to execute common movements with the high-level drive command. Use the emergency stop to immediately halt all motion if needed.

Core operations you will perform include driving the robot forward, backward, or turning by varying the left and right track speeds. The left and right tracks can be set to speeds in the range -1.0 to 1.0, where negative values reverse direction. When you want to stop all motion, invoke the stop tool to halt both motors instantly.

How to install

uv run kentrabot

python3 src/kentrabot_mcp/server.py

Additional notes

Prerequisites include Python 3.11 or higher and a preferred runtime (uv or pip). The server is provided with a modular driver system and currently uses a Dummy driver for simulation and testing. You can extend it to real hardware by implementing a new driver in the codebase and configuring the server to initialize that driver.

Tools are exposed via the MCP interface: move sets independent track speeds, drive moves in a direction with a specified speed, and stop halts all motion. Hardware configurations are modular, with the default being a simulated driver.

Available tools

move

Set independent speeds for the left and right tracks. You can specify left_speed and right_speed values between -1.0 and 1.0 to control each track separately.

drive

Move in a specific overall direction, such as forward, backward, left, or right, by providing a direction and a speed multiplier.

stop

Halt all motor activity immediately by stopping both tracks.