机器人控制协议服务器

KentraBOT MCP服务器

一 MCP（模型上下文协议） 用于控制双轨机器人的服务器。该服务器公开了控制电机速度和方向的工具，允许LLM驱动机器人。

特性

• 部队移动控制：独立控制左右轨道。
• 高级命令: drive 用于轻松控制方向（向前、向后、向左、向右）的工具。
• 安全：紧急情况 stop 工具。
• 硬件抽象：采用模块化驱动系统。当前配置为 Dummy 用于模拟/测试的驱动程序。

安装

先决条件

• Python 3.11或更高版本
• uv （推荐）或 pip

设置

1. 克隆存储库:

   复制

   git clone <repository-url>
   cd kentraBOT-MCP
   

2. 安装依赖项: 使用 uv:

   复制

   uv sync
   

   或使用标准 pip:

   复制

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

用法

运行服务器

使用启动MCP服务器 uv:

uv run kentrabot

或者直接使用python：

python3 src/kentrabot_mcp/server.py

连接到MCP客户端

配置您的MCP客户端（例如，Claude Desktop、MCP Inspector）以运行上述服务器命令。

示例 claude_desktop_config.json:

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

工具

硬件配置

当前，服务器设置为使用 DummyRobot 将操作记录到控制台的驱动程序。

要使用真正的硬件（例如，带电机帽的Raspberry Pi）：

1. 在中实施新驱动程序 src/kentrabot_mcp/drivers/.
2. 从……继承…… kentrabot_mcp.robot.Robot.
3. 更新 src/kentrabot_mcp/server.py 初始化您的新驱动程序。