Amanasmuei MCP Server Nodemcu

🚀 NodeMCU 物聯網設備管理平臺

NodeMCU 物聯網設備管理平臺是一個基於 NodeMCU 和 WebSocket 的解決方案，可讓用戶通過 Web 界面和 RESTful API 遠程配置與監控 NodeMCU 設備，為物聯網設備管理帶來便捷。

🚀 快速開始

服務器端

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 設備，支持按 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/             # 靜態資源，如 logo
├── 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 優秀的物聯網平臺
• Anthropic 提供 Claude Desktop