Goose Gets a Driver's License!

--- title: Goose Gets a Driver's License! description: Control a MakeBlock mbot2 rover through MQTT and MCP as a Goose Extension authors: - ian --- import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed'; ![blog cover](goose-rover-blog.png) ## I taught Goose how to drive (a rover) Goose has no hands, no eyes, and no spatial awareness, but it can drive a rover! I came across [a demo video](https://x.com/deemkeen/status/1906692248206524806) from [Deemkeen](https://github.com/deemkeen), where he used [Goose](/) to control a [Makeblock mbot2 rover](https://www.makeblock.com/products/buy-mbot2) using natural language commands like "drive forward/backward," "beep," and "turn left/right" powered by a Java-based MCP server and MQTT. Inspired and excited to take it further, I taught the rover to spin, blink colorful lights, and help me take over the world! ## Getting Started with MQTT I needed to get a few tools installed on my development environment, including Docker, MQTT (`brew install mosquitto`), and Java. A Docker Compose file was provided to get started with MQTT, and I needed to make a few changes, and create some subfolders to store data. Goose helped with these instructions: ```yaml version: '3.8' services: mosquitto: image: eclipse-mosquitto hostname: mosquitto container_name: mosquitto restart: unless-stopped command: /usr/sbin/mosquitto -c /etc/mosquitto/config/mosquitto.conf -v ports: - "0.0.0.0:1883:1883" - "9001:9001" volumes: - ./mosquitto:/etc/mosquitto - ./mosquitto/data:/mosquitto/data - ./mosquitto/log:/mosquitto/log ``` ```sh mkdir -p mosquitto/data mosquitto/log mosquitto/config ``` Then a `docker compose up` command started the MQTT server. :::info By default, this setup will not use authentication for MQTT, but in a production environment, these would be important to set up to avoid unauthorized access to the MQTT server. ::: To make sure everything was working, I could run a few commands to test that I could subscribe to a channel on my MQTT Docker container and publish messages to it from another terminal window: ```sh Terminal 1 # terminal 1: subscribe to a channel called "MBOT/TOPIC" mosquitto_sub -h localhost -p 1883 -t MBOT/TOPIC -v ``` ```sh Terminal 2 # terminal 2: publish a message to the channel "MBOT/TOPIC" mosquitto_pub -h localhost -p 1883 -t MBOT/TOPIC -m "BEEP" ``` We see the resulting message in terminal 1: ```sh # terminal 1 sees this output: MBOT/TOPIC BEEP ``` ## Setting Up the mbot2 After the assembly of the mbot2 rover, which took about 15 minutes, I used Makeblock's web-based IDE to copy/paste Deemkeen's [Python code](https://github.com/deemkeen/mbotmcp/blob/main/assets/mbot-mqtt.py) to the IDE and upload it to the mbot2. I added appropriate values for wifi, MQTT server, and which MQTT "topic" to subscribe to for commands. Once the mbot2 rebooted to use the new code, I could reissue the "BEEP" command from my terminal, and the mbot2 beeped. so it was on to the next step. ## Setting up the local MCP server I had some trouble compiling the Java MCP server (I'm a Python developer), but I was able to get the MCP server compiled by skipping the tests for the time being: ```sh mvn clean package -DskipTests ``` This created a JAR file that we could run on the command line: ```sh # 3 required environment variables for MQTT export MQTT_SERVER_URI=tcp://localhost:1883 export MQTT_USERNAME="" export MQTT_PASSWORD="" /path/to/java -jar /path/to/mbotmcp-0.0.1-SNAPSHOT.jar ``` To test that MCP was working, I used the MCP inspector tool to send commands to MQTT. ```sh npx @modelcontextprotocol/inspector /path/to/java -jar /path/to/mbotmcp-0.0.1-SNAPSHOT.jar ``` This starts up a local web server (the command line output will tell you which port to access in your browser, i.e., localhost:6274), where you can "connect" to the server, and request a list of tools, resources, prompts, from the MCP server. In this case, I see a list of tools available such as "mbotBeep" or "mbotExplore". ![mcp tool list](mcp-tool-list.png) ## Goose learns how to drive! Following our [mbot MCP tutorial](/docs/mcp/mbot-mcp/) we can set up our MCP extension just like we ran our Java JAR file with the environment variables. Now we can give Goose commands like "drive in a square pattern by making left turns and moving forward, and beeping before you turn" and it will send the commands to the mbot2 rover via MQTT. I didn't want my mbot2 rover to gain too much territory, so I decided to make some modifications to limit how far it would go. ### Modifications I made to the Python code Deemkeen's Python code allows for the following commands: - "turn left" or "turn right" - drive "forward" or "backward" - "explore" randomly - "stop" exploring - "beep" The default distance in Deemkeen's code seemed a little long, and the turn angles are set to 90 degrees. I shortened the distance the mbot could drive, and to turn at 45 degrees instead. I added a "spin" command for both clockwise and counter-clockwise, and a "blink" command to change the color of the lights on the mbot2. There are a large number of API calls available to access the mbot2 [motor hardware and sensors](https://www.yuque.com/makeblock-help-center-en/mcode/cyberpi-api-shields#9eo89). Next, I had to make sure my Java code was updated to include these new commands to send an appropriate "SPINLEFT" or "BLINKRED" commands to MQTT so the rover could respond to the commands properly. Finally, the rover includes an ultrasonic distance sensor, which look like "eyes" on the rover, which I felt was more appropriate to be the "front" of the rover, so I reversed Deemkeen's direction code in Python to move the wheels in the opposite direction from Deemkeen's original code. ## Goose changes for the video I grew up with Pinky and the Brain, and I wanted to have some fun with the mbot2 extension. I decided to add a few "Evil AI" commands to Goose to make it seem like it was trying to "take over the world." I added the following instructions to my [.goosehints](/docs/guides/context-engineering/using-goosehints/) file to include fun instructions for the mbot2 extension: ``` If I ask you "what do you want to do tonight, Goose?" I want you to reply with "The same thing we do every night, Ian. TRY TO TAKE OVER THE WORLD!!!!" and tell my mbot2 rover to blink its lights red, then start exploring. ``` For the video recording, I used a voice modifier to narrate Goose's response in a "robotic" voice, but I'm sure someone will create an MCP server for text-to-speech soon enough! ## Credit where it's due We want to extend a huge thank you to [deemkeen](https://x.com/deemkeen) for their open-source work which inspired this project, and to the Makeblock team for creating such a fun rover to work with. We're always excited to see what the community is up to. If you're working on your own Goose-powered experiment, come share it with us on [Discord](https://discord.gg/goose-oss)!