MCP for IOT

面向 IoT 的 MCP

面向 IoT 设备（Arduino）的 Model Context Protocol (MCP) 服务

概述

面向 IoT 的 MCP 是 Model Context Protocol (MCP) 服务的 Go 实现，可让 Claude 等 AI 模型直接与 IoT 设备交互，尤其是 Arduino 开发板。此服务充当 Claude 与 Arduino 硬件之间的桥梁，实现由 AI 控制的硬件自动化。

功能

• 🔌 列出可用的串行端口
• 📡 读取 Arduino 串行端口的数据
• 🚦 控制数字引脚（LED、继电器等）
• 🔊 控制蜂鸣器的开关和持续时间
• 🤖 与 Claude AI 无缝集成

用法

https://github.com/user-attachments/assets/46d7d731-f5d0-4acd-b53e-c00be8b83215

前提条件

• Go（版本 1.24 或更高）
• 带 USB 连接的 Arduino 硬件
• Claude 桌面应用或兼容的 MCP 客户端

安装

从源代码构建

git clone https://github.com/sukeesh/mcp-iot-go.git
cd mcp-iot-go
go install

二进制文件将安装到 GOBIN 目录，该目录应位于 PATH 中。

Arduino 设置

1. 将 Arduino 连接到计算机
2. 上传提供的 Arduino 固件：

   arduino/firmware.ino
   

此固件通过串行通信接收命令：

• M,pin,mode - 设置引脚模式（例如，M,6,OUTPUT）
• D,pin,value - 控制数字引脚（例如，D,6,HIGH 或 D,6,LOW）
• BZ,pin,state - 控制蜂鸣器（例如，BZ,8,ON 或 BZ,8,OFF）

配置 MCP 客户端

配置 Claude Desktop：

1. 打开 Claude Desktop → Settings → Developer → Edit Config
2. 将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "iot": {
      "command": "<path-to-mcp-iot-go-binary>",
      "env": {}
    }
  }
}

3. 重启 Claude Desktop

可用工具

工具	描述
port_list	列出所有可用的串行端口
read_serial_line	从指定的串行端口读取一行数据
write_digital	向指定端口上的引脚写入数字值（HIGH/LOW）
buzzer_control	控制连接到 Arduino 引脚的蜂鸣器，可选设置持续时间

使用示例

设置完成后，你可以通过 Claude 直接与 Arduino 硬件交互：

• “列出所有可用的串行端口”
• “读取端口 /dev/cu.usbmodem12401 上 Arduino 的数据”
• “打开引脚 6 上的红色 LED”
• “让引脚 8 上的蜂鸣器响 2 秒”

开发

项目结构

• main.go - MCP 服务设置和工具定义
• internal/tools.go - Arduino 通信工具的实现
• arduino/firmware.ino - 用于处理命令的 Arduino 固件

依赖项

• mcp-go - 用于实现 MCP 的 Go 库
• go.bug.st/serial - 串行端口通信库

贡献

欢迎贡献！请随时提交 Pull Request。