Skip to content

sukeesh/mcp-iot-go

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCP for IOT

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

IOT MCP Logo

Go

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

IOT_MCP.mp4

Prerequisites

  • Go (version 1.24 or later)
  • Arduino hardware with USB connection
  • Claude Desktop App or compatible MCP client

Installation

Build from Source

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:
{
  "mcpServers": {
    "iot": {
      "command": "<path-to-mcp-iot-go-binary>",
      "env": {}
    }
  }
}
  1. 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

Contributing

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

About

MCP Server for Sensors

Resources

Stars

Watchers

Forks

Packages

No packages published