NodeMCU MCP (Model Context Protocol) Service
2025.04.03
1
JavaScriptIoT 设备管理远程控制AI 集成其它
NodeMCU MCP 是一个基于 Model Context Protocol (MCP) 的服务，专为管理 NodeMCU 设备设计。它提供了标准的 RESTful API 和 WebSocket 接口，支持与 AI 工具（如 Claude Desktop）的集成。该服务主要用于监控设备状态、远程发送命令、更新设备配置以及收集设备遥测数据。
View on GitHub
Overview
基本能力
产品定位
NodeMCU MCP 是一个用于管理 ESP8266/NodeMCU IoT 设备的服务，支持通过 RESTful API 和 WebSocket 进行设备监控和控制，同时集成了 Model Context Protocol (MCP) 以便与 AI 工具（如 Claude Desktop）交互。
核心功能
- 设备管理：注册、监控和控制 NodeMCU 设备
- 实时通信：通过 WebSocket 接口实现实时更新
- 配置管理：远程更新设备设置
- 命令执行：远程发送重启、更新、状态等命令
- 遥测收集：收集传感器数据和设备指标
- 认证：使用 JWT 认证保护 API 访问
- AI 集成：与 Claude Desktop 和其他 MCP 兼容的 AI 工具集成
适用场景
- 远程监控和管理 IoT 设备
- 与 AI 工具集成，实现自动化控制
- 实时收集和分析设备数据
工具列表
- list-devices：列出所有注册的 NodeMCU 设备及其状态
- get-device：获取特定 NodeMCU 设备的详细信息
- send-command：向 NodeMCU 设备发送命令
- update-config：更新 NodeMCU 设备的配置
常见问题解答
- 如何与 Claude Desktop 集成？
- 安装 Claude Desktop 并配置
claude_desktop_config.json文件以指向 MCP 服务。 - 如何运行 MCP 服务器？
- 使用命令
npm run mcp或./bin/cli.js --mode=mcp。
使用教程
使用依赖
- Node.js 16.x 或更高版本
- npm 或 yarn
- Arduino IDE（用于 NodeMCU 客户端开发）
安装教程
通过 Smithery 安装
npx -y @smithery/cli install @amanasmuei/nodemcu-mcp --client claude
通过 npm 安装
npm install -g nodemcu-mcp
从源码安装
git clone https://github.com/amanasmuei/nodemcu-mcp.git
cd nodemcu-mcp
npm install
npm install -g .
调试方式
运行 API 服务器
开发模式：
npm run dev
生产模式：
npm start
运行 MCP 服务器
npm run mcp
或
nodemcu-mcp --mode=mcp