使用说明

项目简介

Chotu Robo MCP服务器是一个使用Model Context Protocol (MCP) 框架构建的项目，旨在实现通过AI控制Arduino机器人。它作为一个桥梁，连接AI系统和Arduino硬件，允许用户通过标准化的MCP接口，利用AI助手来控制和操作机器人。该服务器定义了一系列工具和Prompt，用于控制机器人的各种功能，如LED灯控制、电机驱动、传感器数据读取等。

主要功能点

硬件控制工具: 提供多种工具来控制连接到Arduino或ESP32的硬件组件，包括LED、蜂鸣器、电机、舵机、风扇、继电器等。
传感器数据读取: 支持读取温度传感器和超声波距离传感器的数据。
AI Prompt集成: 预定义Prompt模板，方便AI系统通过自然语言指令控制机器人行为，如移动、启动、停止、转向和调整速度。
两种运行模式: 支持有线模式（Arduino Nano 368）和无线模式（ESP32），适应不同的应用场景和硬件配置。
MCP协议标准: 遵循Model Context Protocol，确保与兼容MCP协议的客户端（如AI助手）无缝集成。

安装步骤

安装 Node.js: 确保你的开发环境中已安装 Node.js 和 npm。

安装依赖: 在项目根目录下，运行以下命令安装所需的 npm 包：

npm install johnny-five @modelcontextprotocol/sdk

配置 Arduino IDE: 如果使用 Arduino Nano 368 或 ESP32，请确保已安装 Arduino IDE 并配置好相应的开发板支持。
上传代码到开发板: 根据项目文档（仓库中可能包含 Arduino 代码，但此处未提供），将相应的 Arduino 代码上传到 Arduino Nano 368 或 ESP32 开发板。
运行 MCP 服务器: 根据需要选择有线模式或无线模式，运行相应的服务器脚本。
- 有线模式 (Arduino Nano 368): 运行 'node build/choturobo.js' (可能需要先使用 'tsc src/choturobo.ts --outDir build' 编译 TypeScript 代码)
- 无线模式 (ESP32): 运行 'node build/chotuwireless.js' (可能需要先使用 'tsc src/chotuwireless.ts --outDir build' 编译 TypeScript 代码)

服务器配置

MCP 客户端需要以下配置信息来连接 Chotu Robo MCP 服务器。请根据你选择的运行模式选择相应的配置。

有线模式 (choturobo.js):

{
  "serverName": "ChotuRoboServer",
  "command": "node",
  "args": ["build/choturobo.js"]
}

无线模式 (chotuwireless.js):

{
  "serverName": "ChotuRoboServer",
  "command": "node",
  "args": ["build/chotuwireless.js"]
}

配置参数说明:

'serverName': 服务器名称，设置为 "ChotuRoboServer"。
'command': 启动服务器的命令，这里使用 'node' 运行 Node.js 脚本。
'args': 命令参数，指定要运行的服务器脚本文件路径。

基本使用方法

启动服务器: 按照安装步骤中的说明启动 Chotu Robo MCP 服务器。
配置 MCP 客户端: 在 MCP 客户端（如AI助手或MCP Inspector）中，配置上述服务器连接信息。
连接服务器: 在 MCP 客户端中发起连接，成功连接后，客户端将能够发现 Chotu Robo 服务器提供的工具和 Prompt。
调用工具和 Prompt: 通过 MCP 客户端，可以调用服务器提供的工具来控制机器人硬件，或使用预定义的 Prompt 与 AI 进行交互，从而间接控制机器人。例如，可以调用 'blinkLED' 工具控制LED灯闪烁，或使用 'move-chotu' Prompt 指示AI助手控制机器人移动。

关键词