NodeMCU MCP

NodeMCU MCP is an MCP server that connects Claude Desktop and other MCP-compatible clients to ESP8266 and NodeMCU IoT hardware. Embedded systems developers and IoT engineers use it to monitor microcontroller states, review live telemetry, and issue operational commands through natural language interfaces. The service operates simultaneously as a standard RESTful API/WebSocket interface and an MCP endpoint using the official Model Context Protocol TypeScript SDK. By bridging AI assistants with networked microcontrollers, NodeMCU MCP enables users to query registered hardware units, examine sensor telemetry such as temperature and humidity, adjust device configurations remotely, and trigger administrative tasks like device restarts. It also includes secure API access managed through JSON Web Token authentication. This architecture lets developers inspect hardware diagnostics, check Wi-Fi signal strength and uptime metrics, and automate operational routines on physical IoT prototypes or deployed home automation devices without manually switching to custom REST clients or serial monitors.

Category: Cloud & Infrastructure

Tags: embedded, esp8266, firmware, iot, nodemcu

Visit NodeMCU MCP

How to install and configure NodeMCU MCP

Follow these steps to install and configure NodeMCU MCP for Claude Desktop: 1. Install the package globally via npm, install via Smithery using npx -y @smithery/cli install @amanasmuei/nodemcu-mcp --client claude, or clone the repository directly: bash git clone https://github.com/amanasmuei/nodemcu-mcp.git cd nodemcu-mcp npm install 2. Open your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json. 3. Add the server entry pointing to the SDK entry point: json { "mcpServers": { "nodemcu": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/YOUR/PROJECT/mcp_server_sdk.js" ] } } } 4. Save the configuration and restart Claude Desktop.

What you can do with NodeMCU MCP

• Query registered ESP8266 devices to inspect current online availability, IP addresses, and active firmware versions. - Retrieve real-time telemetry datasets including temperature, humidity, heap memory usage, uptime, and Wi-Fi RSSI levels. - Send hardware execution commands directly to microcontrollers, such as executing remote system restarts across active nodes. - Update operational device configurations remotely, including altering telemetry reporting intervals, debugging toggles, and onboard LED states.

Key facts

• Open Source
• https://github.com/amanasmuei/nodemcu-mcp
• Cloud & Infrastructure, Developer Tools & Code Intelligence
• embedded, esp8266, firmware, iot, nodemcu

Part of MCP Servers

What is NodeMCU MCP?

NodeMCU MCP is an open source Model Context Protocol service designed to bridge ESP8266 and NodeMCU IoT devices with AI assistants. It exposes tools for monitoring telemetry, retrieving device configurations, and executing remote commands.

Which MCP tools are included in NodeMCU MCP?

The server includes four core tools: list-devices to display registered hardware and statuses, get-device to view detailed configuration and sensor telemetry, send-command to transmit instructions like restarts, and update-config to modify device parameters.

Which clients work with NodeMCU MCP?

NodeMCU MCP works with Claude Desktop and any client supporting the Model Context Protocol. It can also operate as a standalone REST and WebSocket service accessible via standard HTTP clients or custom dashboards.

Is NodeMCU MCP open source?

Yes, NodeMCU MCP is open source software distributed under the permissive MIT License. Users are free to inspect, modify, and distribute the source code for both private and commercial deployments.