esp-mcp
by horw
Centralize ESP32 related commands and simplify getting started with seamless, LLM-driven interaction and help.
131stars
13forks
Python
Added 12/27/2025
MCP Serversesp-idfesp32mcpmcp-server
Installation
# Add to your Claude Code skills
git clone https://github.com/horw/esp-mcp
Goal
The goal of this MCP is to:
- Consolidate ESP-IDF and related project commands in one place.
- Simplify getting started using only LLM communication.
How to contribute to the project
Simply find a command that is missing from this MCP and create a PR for it!
If you want someone to help you with this implementation, just open an issue.
Notice
This project is currently a Proof of Concept (PoC) for an MCP server tailored for ESP-IDF workflows.
Current Capabilities:
Core Features:
run_esp_idf_install: Install ESP-IDF dependencies and toolchain viainstall.sh.create_esp_project: Create a new ESP-IDF project.setup_project_esp_target: Set target chip for ESP-IDF projects (esp32, esp32c3, esp32s3, etc.).build_esp_project: Build ESP-IDF projects with incremental build support.list_esp_serial_ports: List available serial ports for ESP devices.flash_esp_project: Flash built firmware to connected ESP devices.run_pytest: Run pytest tests with pytest-embedded support for ESP-IDF projects.
Additional Features:
- Flexible ESP-IDF path management: supports per-project ESP-IDF versions via
idf_pathparameter. - SDK config management: supports custom
sdkconfig_defaultsfiles for build configuration (multiple files can be specified separated by semicolons).