Esp Mcp

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.

FAQ from Esp Mcp

What is Esp Mcp and what does it do?

It is an MCP server that provides a set of tools to interact with ESP-IDF projects, allowing LLMs or chatbots to perform development tasks like installing dependencies, building, flashing, and testing.

How do I install Esp Mcp?

Clone the repository from GitHub (git clone [email protected]:horw/esp-mcp.git) and configure it in your chatbot using a JSON snippet that includes the command path, arguments, and optionally the IDF_PATH environment variable pointing to your ESP-IDF installation.

Does Esp Mcp require ESP-IDF to be installed?

Yes. ESP-IDF must be installed on your system. You can specify its location via the IDF_PATH environment variable or by passing an idf_path parameter directly to each tool call, which supports multiple ESP-IDF versions.

What tools/commands does Esp Mcp provide?

It provides eight core tools: run_esp_idf_install, create_esp_project, setup_project_esp_target, build_esp_project, list_esp_serial_ports, flash_esp_project, and run_pytest.

Is Esp Mcp production-ready?

No. It is currently a Proof of Concept (PoC) for ESP-IDF workflows, with experimental features and planned expansion into broader embedded device interaction.