esp-mcp

Overview

esp-mcp is a Python-based MCP server designed to streamline ESP32 development by providing a unified interface for ESP-IDF commands. It currently supports core operations like ESP-IDF installation, project creation, target configuration, building, serial port listing, and flashing to devices. The server offers flexible ESP-IDF path management, SDK configuration support, and build time tracking. As a proof of concept, it includes experimental features like automatic issue fixing based on build logs, with plans to expand into a comprehensive embedded development toolkit.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• run_esp_idf_install

  Install ESP-IDF dependencies and toolchain via install.sh

  Try:Install ESP-IDF dependencies for the ESP-IDF installation at /path/to/esp-idfTry:Set up ESP-IDF development environment
• create_esp_project

  Create a new ESP-IDF project

  Try:Create a new ESP-IDF project named my_appTry:Initialize a new ESP32 project in /path/to/my-project
• setup_project_esp_target

  Set target chip for ESP-IDF projects

  Try:Set the target chip to esp32s3 for the projectTry:Configure the project to use ESP32-C3 as target
• build_esp_project

  Build ESP-IDF projects with incremental build support

  Try:Build the project located at /path/to/my/esp-projectTry:Build the project with custom sdkconfig defaults
• list_esp_serial_ports

  List available serial ports for ESP devices

  Try:List all available serial ports for ESP devicesTry:Show me which serial ports have connected ESP devices
• flash_esp_project

  Flash built firmware to connected ESP devices

  Try:Flash the firmware to my connected ESP32 deviceTry:Upload the compiled firmware to /dev/ttyUSB0
• run_pytest

  Run pytest tests with pytest-embedded support for ESP-IDF projects

  Try:Run pytest tests for the project targeting esp32c3Try:Execute all tests for the ESP-IDF project

Comparable tools

Installation

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

{
  "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>"
      }
    }
  }
}

FAQ

What ESP32 targets are supported?

The server supports ESP32, ESP32-C3, ESP32-S3, and other ESP-IDF compatible targets through the setup_project_esp_target function.

Can I use different ESP-IDF versions for different projects?

Yes, the server supports per-project ESP-IDF versions via the idf_path parameter in tools or the IDF_PATH environment variable.

Compare esp-mcp with