An MCP server that integrates ESP-IDF commands for building, flashing, and managing ESP32/ESP device projects through LLM interaction.

Installation

From Source Code

git clone git@github.com:horw/esp-mcp.git

Configuration

MCP Server Configuration

{
    "mcpServers": {
        "esp-run": {
            "command": "<path_to_uv_or_python_executable>",
            "args": [
                "--directory",
                "<path_to_cloned_esp-mcp_repository>",
                "run",
                "main.py"
            ],
            "env": {
                "IDF_PATH": "<path_to_your_esp-idf_directory>"
            }
        }
    }
}

Features

• Supports basic ESP-IDF project build commands
• Flash built firmware to connected ESP devices with optional port specification
• Experimental support for automatic issue fixing based on build logs
• Consolidates ESP-IDF and related project commands in one place
• Simplifies getting started using only LLM interaction

Environment Variables

Required

• IDF_PATH - Must point to the root directory of your ESP-IDF installation

Usage Examples

Build the project located at `/path/to/my/esp-project` using the `esp-mcp`

Clean the build files for the ESP32 project in the `examples/hello_world` directory

Flash the firmware to my connected ESP32 device for the project in `my_app`

Notes

This project is currently a Proof of Concept (PoC). Future plans include extended support for ESP-IDF commands (monitor, menuconfig), device management, and integration with other embedded systems development tools and platforms. Requires a separate ESP-IDF installation.