Esp MCP Server

What is Esp Mcp?

Esp Mcp is a Model Context Protocol (MCP) server that consolidates ESP-IDF and related project commands into a single interface, simplifying embedded development through LLM communication. It is currently a Proof of Concept (PoC) tailored for ESP-IDF workflows.

How to use Esp Mcp?

Clone the repository and configure it in your MCP-supporting chatbot using a JSON snippet that specifies the command (path to uv or Python), arguments, and optional IDF_PATH environment variable. Once running, you can ask your chatbot to execute ESP-IDF commands like installing dependencies, creating projects, setting targets, building, flashing, and running pytest tests.

Key features of Esp Mcp

• Install ESP-IDF dependencies and toolchain via install.sh.
• Create new ESP-IDF projects.
• Set target chip for projects (e.g., esp32, esp32c3, esp32s3).
• Build projects with incremental build support.
• List available serial ports for ESP devices.
• Flash built firmware to connected devices.
• Run pytest tests with pytest-embedded support.
• Flexible per-project ESP-IDF path management.
• SDK config management using custom sdkconfig_defaults files.
• Build time tracking and optional port specification for flashing.

Use cases of Esp Mcp

• Set up a new ESP-IDF development environment from scratch.
• Create, build, and flash ESP32 firmware projects using natural language.
• Run automated tests for multiple ESP targets across different projects.
• Manage multiple ESP-IDF versions per project without manual environment switching.
• Debug build issues with experimental automatic log-based fix suggestions.