ESP32 CYD開発ボード向けMCPプロトコルのハードウェア遠隔制御ソリューション

たんさく

Esp Cyd MCP

ESP32 CYD開発ボードのMCPサーバー実装で、WebSocketプロトコルを通じてディスプレイ、タッチ、GPIO、センサーなどのハードウェア機能をリモートで制御する完全なソリューションを提供します。

家庭自動化とIoT 開発者ツール #ハードウェア制御 #WebSocket #リモートインタラクション #IoT .cpp

スコア : 2.5ポイント

ダウンロード数 : 6.4K

更新時間 : 2025-08-07

サイトを開く

ESP32 CYD MCPサーバーとは？

これはESP32 - 2432S028R開発ボード専用のリモートコントロールサーバーで、WebSocket通信とMCPプロトコルを採用し、ネットワークを通じて開発ボードのディスプレイ、タッチ機能、GPIOインターフェース、および各種センサーをリモートで制御できます。

ESP32 CYD MCPサーバーの使い方は？

1. ファームウェアを開発ボードに書き込む 2. 開発ボードのWiFiネットワークに接続する 3. WebSocketクライアントを通じてJSON形式の制御コマンドを送信する 4. 開発ボードからの応答とイベント通知を受信する

適用シーン

IoTデバイスのプロトタイプ開発、スマートホームコントロールパネル、教育用デモツール、産業機器の監視インターフェースなど、リモートでディスプレイとセンサーを制御する必要があるシーン。

主な機能

ディスプレイ制御

文字の描画、図形の描画、バックライトの制御など20種類以上の表示操作をサポートします。

タッチ機能

タッチ状態の取得、タッチスクリーンのキャリブレーション、タッチイベントのシミュレートなど10種類以上のタッチ関連機能を提供します。

GPIO制御

デジタル/アナログ入出力、PWM制御、割り込み処理など15種類のGPIO操作が可能です。

センサー監視

温度、光、ホール効果などのセンサーデータを読み取り、キャリブレーションと一括読み取りをサポートします。

ネットワークツール

WiFi接続管理、HTTPリクエスト、NTP時間同期など15種類のネットワーク機能を備えています。

ファイル管理

SPIFFSとSDカードのファイルの読み書き、ディレクトリ操作など15種類のファイルシステム機能をサポートします。

利点

ディスプレイ、タッチ、GPIO、センサーなどの様々な方面にわたる豊富な機能を備えています。

標準のWebSocketプロトコルに基づいているため、様々なクライアントと互換性があります。

リアルタイム双方向通信をサポートし、イベント通知が可能です。

モジュール化設計なので、新機能の拡張が容易です。

制限

ESP32 - 2432S028R開発ボードのみをサポートしています。

ネットワーク接続が必要です。

一部の高度な機能には追加のハードウェアが必要です。

使い方

開発環境のインストール

PlatformIOまたはArduino IDE開発環境をインストールします。

プロジェクトコードの取得

GitHubリポジトリをローカルにクローンします。

ファームウェアのコンパイルとアップロード

PlatformIOを使用して開発ボードにコンパイルしてアップロードします。

開発ボードへの接続

WiFiを通じて開発ボードに接続し、IPアドレスを取得します。

制御コマンドの送信

WebSocketクライアントを使用してサーバーに接続し、JSON形式のコマンドを送信します。

使用例

歓迎メッセージの表示

画面中央に歓迎メッセージを表示します。

温度監視画面の作成

定期的に温度センサーを読み取り、画面に表示します。

よくある質問

タッチスクリーンが不正確な問題をどう解決しますか？

ディスプレイが反応しないのはなぜですか？

新しい機能をどう拡張しますか？

どのようなプログラミング言語のクライアントをサポートしていますか？

🚀 ESP32 CYD MCP サーバ

ESP32 CYD（Cheap Yellow Display）ボード用の包括的なモデルコンテキストプロトコル（MCP）サーバ実装です。このプロジェクトは、WebSocketベースのMCPインターフェイスを通じてESP32 - 2432S028Rボードに広範なリモートコントロール機能を提供します。

✨ 主な機能

MCPサーバコア

WebSocketベースのMCPプロトコル実装
JSON - RPC 2.0準拠
リアルタイム双方向通信
複数クライアントサポート
イベント通知

ツールカテゴリ

表示ツール（20以上のツール）

display.clear - 色付きで画面をクリア
display.text - 位置とスタイルを指定してテキストを描画
display.line - 太さを指定して線を描画
display.rectangle - 矩形の輪郭を描画
display.fillRectangle - 塗りつぶした矩形を描画
display.circle - 円の輪郭を描画
display.fillCircle - 塗りつぶした円を描画
display.pixel - 個々のピクセルを描画
display.backlight - バックライトのオン/オフを制御
display.brightness - 表示の明るさを設定（0 - 255）
display.rotation - 表示の回転を設定（0 - 3）
display.progressBar - プログレスバーを描画
display.info - 表示情報を取得

タッチツール（10以上のツール）

touch.getState - 現在のタッチ状態を取得
touch.enable - タッチ入力の有効/無効を切り替え
touch.calibrate - タッチスクリーンをキャリブレーション
touch.getHistory - 最近のタッチイベントを取得
touch.simulate - タッチイベントをシミュレート
touch.getCalibration - キャリブレーション値を取得
touch.saveCalibration - キャリブレーションをファイルに保存
ジェスチャー検出（スワイプサポート）

GPIOツール（15以上のツール）

gpio.pinMode - ピンモードを設定（入力/出力/PWM）
gpio.digitalWrite - デジタル値を書き込む
gpio.digitalRead - デジタル値を読み取る
gpio.analogWrite - PWM出力
gpio.analogRead - アナログ値を読み取る
gpio.attachInterrupt - 割り込みをアタッチ
gpio.setPWM - 周波数を指定してPWMを設定
gpio.tone - 音を生成
gpio.pulseIn - パルスの持続時間を測定

センサーツール（10以上のツール）

sensor.readTemperature - 温度センサーを読み取る
sensor.readLight - 光センサーを読み取る
sensor.readInternalTemp - ESP32の内部温度を読み取る
sensor.readHallSensor - 内蔵のホールセンサーを読み取る
sensor.readBatteryVoltage - 電源電圧を読み取る
sensor.readAll - すべてのセンサーを一度に読み取る
sensor.calibrate - センサーをキャリブレーション
sensor.getEnvironment - 環境の概要を取得

ネットワークツール（15以上のツール）

network.status - ネットワーク状態を取得
network.connect - WiFiに接続
network.scan - ネットワークをスキャン
network.startAP - アクセスポイントを起動
network.httpRequest - HTTPリクエストを送信
network.ping - ホストをping
network.getTime - NTP時間を取得
network.setMDNS - mDNSを設定

システムツール（20以上のツール）

system.info - 包括的なシステム情報
system.restart - ESP32を再起動
system.sleep - ディープ/ライトスリープモード
system.memory - メモリ統計情報
system.tasks - FreeRTOSタスク情報
system.setCPUFrequency - CPU速度を制御
system.performanceMode - パフォーマンスを最適化
system.factoryReset - 工場出荷時設定にリセット

ファイルツール（15以上のツール）

file.list - ファイル/ディレクトリを一覧表示
file.read - ファイル内容を読み取る
file.write - ファイルに書き込む
file.delete - ファイルを削除
file.mkdir - ディレクトリを作成
file.copy - ファイルをコピー
file.storage - ストレージ統計情報
SPIFFSとSDカードのサポート

オーディオツール（15以上のツール）

audio.tone - 単音を再生
audio.playMelody - メロディを再生
audio.beep - 単純なビープ音を再生
audio.playPattern - カスタム音パターンを再生
audio.notification - 通知音を再生
audio.alarm - アラームパターンを再生
audio.setVolume - 音量を制御
事前定義されたメロディ（マリオ、スターウォーズなど）

📦 インストール

PlatformIOまたはArduino IDEをインストール
このリポジトリをクローン
PlatformIOでプロジェクトを開く
ビルドしてESP32 CYDボードにアップロード

git clone https://github.com/yourusername/esp32-cyd-mcp
cd esp32-cyd-mcp
pio run -t upload

📚 ドキュメント

設定

include/config.hを編集して以下をカスタマイズします。

WiFi資格情報
ピン割り当て
サーバポート
表示設定
センサーキャリブレーション

使用方法

MCPサーバへの接続

ESP32 CYDボードの電源を入れる
WiFiに接続するか、APモードを使用する
表示画面でデバイスのIPアドレスを見つける
WebSocketを通じてws://[IP]:3001に接続する

例MCPリクエスト

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/invoke",
  "params": {
    "name": "display.text",
    "arguments": {
      "text": "Hello MCP!",
      "x": 50,
      "y": 100,
      "color": "white",
      "size": 2
    }
  }
}

Claude Desktopでの使用

Claude Desktopの設定に以下を追加します。

{
  "mcpServers": {
    "esp32-cyd": {
      "command": "websocat",
      "args": ["ws://192.168.1.100:3001"]
    }
  }
}

APIドキュメント

ツール呼び出し

すべてのツールは標準のMCP tools/invokeメソッドを使用して呼び出されます。

{
  "method": "tools/invoke",
  "params": {
    "name": "tool.name",
    "arguments": { ... }
  }
}

イベント通知

サーバは様々なイベントに対して通知を送信します。

touch.event - タッチ入力イベント
sensor.update - 定期的なセンサー更新
network.event - ネットワーク状態の変更
gpio.interrupt - GPIO割り込みイベント

開発

新しいツールの追加

include/tools/にヘッダーファイルを作成
src/tools/で実装
registerTools()メソッドでツールを登録
main.cppで初期化を追加

プロジェクト構造

esp32-cyd-mcp/
├── include/
│   ├── config.h           # 設定
│   ├── mcp_server.h       # MCPサーバコア
│   └── tools/            # ツールヘッダー
├── src/
│   ├── main.cpp          # メインアプリケーション
│   ├── mcp_server.cpp    # MCP実装
│   └── tools/           # ツール実装
├── platformio.ini        # PlatformIO設定
└── README.md