ESP32 Control

ESP32 MCP 服务

直接通过 AI Agent（Claude、Cursor 或任何 MCP 客户端）控制和读取 ESP32 IoT 设备。

• esp32.status — 在线状态 / 芯片 / 可用堆内存 / 运行时间
• esp32.gpio_set — 将 GPIO 设置为高电平 / 低电平
• esp32.gpio_read — 读取数字引脚
• esp32.adc_read — 读取模拟电压（mV）
• esp32.send_command — 原始 AT / 应用命令
• esp32.reboot — 重启设备

架构

AI agent (Claude/Cursor)  →  this MCP server (Python)  →  ESP32 REST API  →  device

ESP32 运行精简的 MicroPython 固件（esp32_firmware/main.py），在 80 端口提供轻量级 REST API。MCP 服务通过 HTTP 与其通信，支持本地和远程使用。

快速开始

1. 刷写 ESP32 固件

1. 在 ESP32 上安装 MicroPython。
2. 将 esp32_firmware/main.py 上传为 main.py（使用 Thonny 或 mpremote）。
3. 开机后，设备会创建名为 ESP32-MCP 的 WiFi AP（密码为 12345678）；或者，你也可以在固件中设置 STA 模式以接入网络。

2. 运行 MCP 服务

pip install esp32-mcp
export ESP32_HOST=http://192.168.4.1     # device address (AP default)
esp32-mcp                                  # stdio transport (local MCP client)

对于远程 Agent，使用 HTTP 传输运行：

uv run esp32-mcp --transport http --port 8000

3. 添加到 AI 客户端

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "esp32": {
      "command": "esp32-mcp",
      "env": { "ESP32_HOST": "http://192.168.4.1" }
    }
  }
}

Cursor：Settings → MCP → Add server → 添加 esp32-mcp，并设置环境变量 ESP32_HOST。

然后只需询问：“打开 GPIO 2”、“引脚 34 的 ADC 读数是多少？”或“重启设备”。

配置

环境变量	默认值	含义
ESP32_HOST	http://192.168.4.1	ESP32 REST 端点
ESP32_TIMEOUT	8	请求超时时间（秒）

安全

• 默认情况下，GPIO 输出仅限引脚 2, 4, 5, 18, 19（编辑固件中的 GPIO_OUT 可更改）。
• 固件仅在自身网络上监听；在将其暴露到互联网之前，请更改 AP 密码。

定价

套餐	价格	包含内容
免费版	$0	全部 6 个核心工具，单台设备
专业版	$9/mo or $90/yr	多设备、历史记录、批量控制、OTA、webhook

免费版不是试用版，核心工具可永久使用。需要扩展规模时再升级。

许可证

MIT