esp-mcp

概述

esp-mcp 是一个基于 Python 的 MCP 服务器，旨在通过提供统一的 ESP-IDF 命令接口来简化 ESP32 开发流程。它目前支持核心操作，如 ESP-IDF 安装、项目创建、目标配置、构建、串口列表和设备烧录。该服务器提供灵活的 ESP-IDF 路径管理、SDK 配置支持和构建时间跟踪。作为一个概念验证项目，它包含基于构建日志的自动问题修复等实验性功能，并有计划扩展为全面的嵌入式开发工具包。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• run_esp_idf_install

  Install ESP-IDF dependencies and toolchain via install.sh

  试试:Install ESP-IDF dependencies for the ESP-IDF installation at /path/to/esp-idf试试:Set up ESP-IDF development environment
• create_esp_project

  Create a new ESP-IDF project

  试试:Create a new ESP-IDF project named my_app试试:Initialize a new ESP32 project in /path/to/my-project
• setup_project_esp_target

  Set target chip for ESP-IDF projects

  试试:Set the target chip to esp32s3 for the project试试:Configure the project to use ESP32-C3 as target
• build_esp_project

  Build ESP-IDF projects with incremental build support

  试试:Build the project located at /path/to/my/esp-project试试:Build the project with custom sdkconfig defaults
• list_esp_serial_ports

  List available serial ports for ESP devices

  试试:List all available serial ports for ESP devices试试:Show me which serial ports have connected ESP devices
• flash_esp_project

  Flash built firmware to connected ESP devices

  试试:Flash the firmware to my connected ESP32 device试试:Upload the compiled firmware to /dev/ttyUSB0
• run_pytest

  Run pytest tests with pytest-embedded support for ESP-IDF projects

  试试:Run pytest tests for the project targeting esp32c3试试:Execute all tests for the ESP-IDF project

可对比工具

安装

git clone git@github.com/horw/esp-mcp.git

{
  "mcpServers": {
    "esp-run": {
      "command": "<uv 或 python 可执行文件的路径>",
      "args": [
        "--directory",
        "<克隆的 esp-mcp 仓库路径>",
        "run",
        "main.py"
      ],
      "env": {
        "IDF_PATH": "<您的 esp-idf 目录路径>"
      }
    }
  }
}

FAQ

支持哪些 ESP32 目标芯片？

服务器通过 setup_project_esp_target 函数支持 ESP32、ESP32-C3、ESP32-S3 和其他 ESP-IDF 兼容的目标芯片。

可以为不同项目使用不同的 ESP-IDF 版本吗？

是的，服务器通过工具中的 idf_path 参数或 IDF_PATH 环境变量支持每个项目的 ESP-IDF 版本。

esp-mcp 对比