MCP for IOT

Model Context Protocol (MCP) Server for IoT Devices (Arduino)

Overview

MCP for IOT is a Go implementation of the Model Context Protocol (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 (version 1.24 or later)
Arduino hardware with USB connection
Claude Desktop App 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:

code

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": "",
      "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 - Go library for MCP implementation
go.bug.st/serial - Serial port communication library

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Mcp Iot Go

Documentation