Esp Cyd MCP

🚀 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 - 音量を制御
• 事前定義されたメロディ（マリオ、スターウォーズなど）

📦 インストール

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

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

📚 ドキュメント

設定

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

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

使用方法

MCPサーバへの接続

1. ESP32 CYDボードの電源を入れる
2. WiFiに接続するか、APモードを使用する
3. 表示画面でデバイスのIPアドレスを見つける
4. 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割り込みイベント

開発

新しいツールの追加

1. include/tools/にヘッダーファイルを作成
2. src/tools/で実装
3. registerTools()メソッドでツールを登録
4. 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

トラブルシューティング

• WiFi接続問題：config.h内の資格情報を確認
• タッチが機能しない：タッチキャリブレーションツールを実行
• 表示問題：表示の回転設定を確認
• メモリ問題：空きヒープを監視し、ツールの使用を減らす

📄 ライセンス

このプロジェクトはオープンソースで、MITライセンスの下で利用可能です。

貢献

貢献は大歓迎です！バグや機能要求については、プルリクエストを送信するか、イシューを開いてください。

謝辞

• ハードウェアサポートに関してESP32コミュニティ
• 表示ドライバに関してTFT_eSPIライブラリ
• プロトコル設計に関してMCP仕様