mcp-registry/esp-mcp

    ==================
      
       /// MCP ///
      /// ESP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

esp-mcp

by horw

Centralize ESP32-/ESP-IDF-related build & flash commands behind an MCP (Model Context Protocol) server so LLM-based agents can drive embedded workflows via a single endpoint.

89
8
Specialized
GitHub

01

build

Compile an ESP-IDF project (equivalent to running `idf.py build`).

02

fullclean

Remove all build artifacts from an ESP-IDF project (equivalent to `idf.py fullclean`).

03

flash

Flash the previously built firmware to a connected ESP device, with optional port specification (equivalent to `idf.py flash`).

Installation

1. Clone the repository:
git clone https://github.com/horw/esp-mcp.git cd esp-mcp
2. Create and activate a virtual environment (recommended):
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
3. Install Python dependencies:
pip install -r requirements.txt
4. (Optional) Install ESP-IDF tools if you plan to flash/monitor ESP32 devices:
# Follow Espressif’s instructions or use: ./install.sh # on Linux/macOS ./install.ps1 # on Windows PowerShell
5. Configure any required environment variables (adjust names as necessary):
export OPENAI_API_KEY="<your-openai-key>" # For LLM-assisted commands export ESP_IDF_PATH="/path/to/esp-idf" # If not on PATH
6. Start the MCP server:
python -m esp_mcp.server --host 0.0.0.0 --port 8080
7. Verify the service:
curl http://localhost:8080/health

Documentation

License: Unknown – repository.license field is empty and no license file detected.
Updated 7/30/2025