mcp-iot-go

# MCP for IOT <p align="center"> <strong>Model Context Protocol (MCP) Server for IoT Devices (Arduino)</strong> </p> <p align="center"> <img src="https://github.com/user-attachments/assets/6df57c3b-2df6-4adb-93dc-4531f6fb2460" alt="IOT MCP Logo" width="240" /> </p> [](https://github.com/sukeesh/mcp-iot-go/actions) ## Overview MCP for IOT is a Go implementation of the [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that allows AI models like Claude to directly interact with IoT devices, specifically Arduino boards. This server acts as a bridge between Claude and your Arduino hardware, enabling AI-controlled hardware automation. ## Features - 🔌 List available serial ports - 📡 Read data from Arduino's serial port - 🚦 Control digital pins (LEDs, relays, etc.) - 🔊 Control buzzers with on/off and duration settings - 🤖 Seamless integration with Claude AI ## Usage https://github.com/user-attachments/assets/46d7d731-f5d0-4acd-b53e-c00be8b83215 ## Prerequisites - [Go](https://go.dev/doc/install) (version 1.24 or later) - Arduino hardware with USB connection - [Claude Desktop App](https://claude.ai/download) or compatible MCP client ## Installation ### Build from Source ```bash git clone https://github.com/sukeesh/mcp-iot-go.git cd mcp-iot-go go install ``` The binary will be installed to your GOBIN directory, which should be in your PATH. ## Arduino Setup 1. Connect your Arduino to your computer 2. Upload the provided Arduino firmware: ``` arduino/firmware.ino ``` This firmware accepts commands via serial communication: - `M,pin,mode` - Sets pin mode (e.g., `M,6,OUTPUT`) - `D,pin,value` - Controls digital pins (e.g., `D,6,HIGH` or `D,6,LOW`) - `BZ,pin,state` - Controls buzzers (e.g., `BZ,8,ON` or `BZ,8,OFF`) ## Configuration with MCP Client Configure Claude Desktop: 1. Open Claude Desktop → Settings → Developer → Edit Config 2. Add the following to your `claude_desktop_config.json`: ```json { "mcpServers": { "iot": { "command": "<path-to-mcp-iot-go-binary>", "env": {} } } } ``` 3. Restart Claude Desktop ## Available Tools | Tool | Description | |------|-------------| | `port_list` | Lists all available serial ports | | `read_serial_line` | Reads a single line of data from a specified serial port | | `write_digital` | Writes a digital value (HIGH/LOW) to a pin on a specified port | | `buzzer_control` | Controls a buzzer connected to an Arduino pin with optional duration | ## Usage Examples After setup, you can interact with your Arduino hardware directly through Claude: - "List all available serial ports" - "Read data from the Arduino on port /dev/cu.usbmodem12401" - "Turn on the red LED on pin 6" - "Activate the buzzer on pin 8 for 2 seconds" ## Development ### Project Structure - `main.go` - MCP server setup and tool definitions - `internal/tools.go` - Tool implementation for Arduino communication - `arduino/firmware.ino` - Arduino firmware for processing commands ### Dependencies - [mcp-go](https://github.com/mark3labs/mcp-go) - Go library for MCP implementation - [go.bug.st/serial](https://pkg.go.dev/go.bug.st/serial) - Serial port communication library ## Contributing Contributions are welcome! Please feel free to submit a Pull Request.