Amanasmuei MCP Server Nodemcu

🚀 NodeMCU 物联网デバイス管理プラットフォーム

NodeMCU 物联网デバイス管理プラットフォームは、NodeMCU と WebSocket に基づく物联网デバイス管理ソリューションです。このプラットフォームを使用すると、ユーザーは Web インターフェイスと RESTful API を通じて、NodeMCU デバイスをリモートで設定および監視することができます。

✨ 主な機能

• デバイス管理：接続されているすべての NodeMCU デバイスを一覧表示し、ID または名前で検索できます。
• リモート制御：指定されたデバイスにコマンド（再起動、リセットなど）を送信し、実行結果を取得できます。
• データ収集：WebSocket を介して、NodeMCU からのセンサーデータとシステム情報をリアルタイムで受信します。
• 設定管理：各デバイスの設定パラメータ（報告間隔、デバッグモードなど）を表示および変更できます。
• 状態監視：デバイスのリアルタイム状態（ネットワーク信号強度（RSSI）、ヒープメモリ使用状況、稼働時間など）を監視します。

🚀 クイックスタート

サーバー側

1. リポジトリをクローンし、依存関係をインストールします。

   git clone https://github.com/yourusername/nodemcu-mcp.git
   cd nodemcu-mcp
   npm install
   

2. 環境変数を設定します。.env.example をコピーして .env という名前に変更し、関連する設定を記入します。
3. サーバーを起動します。

   node index.js
   

クライアント（NodeMCU デバイス）

1. Arduino IDE で必要なライブラリをインストールします。

   • ESP8266WiFi
   • WebSocketsClient
   • ArduinoJson

2. サンプルコードを設定します。例えば：

   const char* ssid = "YOUR_WIFI_SSID";
   const char* password = "YOUR_WIFI_PASSWORD";
   const char* mcpHost = "your-server-ip";
   const int mcpPort = 3000;
   

3. コードを NodeMCU デバイスにアップロードします。

🔧 技術詳細

プロジェクト構造

nodemcu-mcp/
├── assets/             # 静的リソース（ロゴなど）
├── bin/                # CLI スクリプト
├── examples/           # クライアントサンプルコード
├── middleware/         # Express ミドルウェア
├── routes/             # RESTful API ルート
├── services/           # ビジネスロジック処理
├── .env.example        # 環境変数のサンプル
├── index.js            # サーバーのエントリーファイル
├── mcp_server.js       # MCP プロトコルの実装
├── mcp-manifest.json   # MCP マニフェストファイル
└── package.json        # プロジェクトの設定ファイル

実装原理

1. WebSocket 接続：NodeMCU デバイスは WebSocket プロトコルを使用してサーバーと接続します。
2. ハートビート機構：接続を維持するために、30 秒ごとにハートビートパケットを送信します。
3. コマンド処理：コマンドを受信すると、デバイスはそれを解析して対応する操作（再起動など）を実行し、結果をサーバーに返します。

📄 ライセンス

このプロジェクトは MIT License の下でオープンソース化されています。詳細は LICENSE ファイルを参照してください。

MIT ライセンスにより、以下のことが許可されています。

• 商用利用
• コードの変更
• ソフトウェアの配布
• 非公開利用

唯一の要件は、ライセンスと著作権表示を保持することです。

謝辞

以下のプロジェクトの貢献に感謝します。

• Model Context Protocol 統合規格の提供
• NodeMCU 優れた IoT プラットフォーム
• Anthropic Claude Desktop の提供