NodeMCU MCP (Model Context Protocol) Service

基本能力

产品定位

NodeMCU MCP 是一个用于管理 ESP8266/NodeMCU IoT 设备的解决方案，提供设备监控、远程控制和 AI 集成功能。

核心功能

• 设备管理：注册、监控和控制 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
• 编辑配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json
• 重启 Claude Desktop

使用教程

使用依赖

• 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 .

配置

1. 复制环境变量示例文件

cp .env.example .env

1. 更新 .env 文件

PORT=3000
HOST=localhost
JWT_SECRET=your_strong_random_secret_key
LOG_LEVEL=info

调试方式

运行 API 服务器

开发模式：

npm run dev

生产模式：

npm start

运行 MCP 服务器

npm run mcp

或使用 CLI：

nodemcu-mcp --mode=mcp

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。