ESP32 Control

ESP32 MCP サーバー

AI エージェント（Claude、Cursor、あらゆる MCP クライアント）から ESP32 IoT デバイスを直接制御し、情報を読み取ります。

• esp32.status — オンライン状態／チップ／空きヒープ／稼働時間
• esp32.gpio_set — GPIO を high／low に設定
• 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 は軽量な REST API をポート 80 で公開する、小さな MicroPython ファームウェア（esp32_firmware/main.py）を実行します。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)

リモートエージェントの場合は、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_HOST 環境変数を指定して esp32-mcp を追加します。

あとは、「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 つのコアツールすべて、単一デバイス
Pro	$9/mo or $90/yr	複数デバイス、履歴、一括制御、OTA、ウェブフック

無料プランは試用版ではありません。コアツールをいつまでも利用できます。規模の拡大が必要になったらアップグレードしてください。

ライセンス

MIT