================== /// 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
Specialized01
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