choturobo

Chotu Robo is an MCP server that bridges AI-driven commands with Arduino/ESP32 hardware control. It exposes a set of tools and prompts that let an AI assistant or user remotely operate LEDs, motors, servos, fans, relays, and sensors connected to the microcontroller. The server communicates with hardware via Johnny-Five and the MCP framework, enabling real-time control through REST or WebSocket interfaces. You can trigger actions like blinking an LED, moving a servo, starting a motor, turning a direction, or reading sensor data using AI prompts such as move-chotu, set-chotu-speed, turn-chotu, readTemperature, or readDistance. The system supports both wired (Arduino Nano 368) and wireless (ESP32 with a web server) modes, allowing you to choose between direct USB control or network-based real-time interactions.

Prerequisites:

• Node.js installed on the host machine
• Access to your MCP environment or SDK for integration
• Hardware setup with NodeMCU ESP32 or Arduino Nano 368 and connected sensors/actuators

1. Install Node.js if not already installed

   • macOS/Linux: curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs
   • Windows: download and install from https://nodejs.org/

2. Install required npm packages (example) npm install johnny-five npm install @modelcontextprotocol/sdk

3. Place the MCP server script

   • Put your Chotu Robo MCP server script at path/to/server.js (or adjust the mcp_config accordingly)

4. Run the MCP server

   • node path/to/server.js

5. Configure MCP integration

   • Ensure your MCP environment is aware of the new server under the identifier choturobo and that network/DNS settings allow communication with the ESP32 or Arduino Nano 368 hardware layer.

Tips and common considerations:

• If using Wireless Mode (ESP32), ensure the ESP32 is connected to your Wi-Fi network and the REST/WebSocket endpoints used by MCP are reachable.
• When deploying to production, secure the MCP endpoints and use environment variables to avoid hard-coding credentials.
• Start with simple tools like blinkLED and readTemperature to verify hardware communication before enabling AI-driven prompts like move-chotu or set-chotu-speed.
• If hardware doesn’t respond, check serial connections, baud rates, and ensure Johnny-Five is properly configured to communicate with the specific microcontroller board.
• Documented tools in the README include: blinkLED, buzz, runMotor, moveServo, controlFan, toggleRelay, readTemperature, readDistance, move-chotu, start-chotu, stop-chotu, turn-chotu, set-chotu-speed.