horw/esp-mcp

Цель

Цель этого MCP — следующее:

• Консолидировать команды ESP-IDF и связанных с ними проектов в одном месте.
• Упростить начало с использованием только LLM-коммуникации.

Как внести вклад в проект

Просто найдите команду, которой не хватает в этом MCP, и создайте для неё PR!

Если хочешь, чтобы кто-то помог с этой реализацией, просто откройте проблему.

Уведомление

Этот проект в настоящее время представляет собой Proof of Concept (PoC) для MCP-сервера, адаптированного для рабочих процессов ESP-IDF.

Текущие возможности:

Основные особенности:

• run_esp_idf_install: Установка зависимостей и инструментов ESP-IDF через install.sh.
• create_esp_project: Создать новый проект ESP-IDF.
• setup_project_esp_target: Задать целевой чип для проектов ESP-IDF (esp32, esp32c3, esp32s3 и др.).
• build_esp_project: Создание проектов ESP-IDF с постепенной поддержкой билдов.
• list_esp_serial_ports: Список доступных последовательных портов для устройств ESP.
• flash_esp_project: Flash собрал прошивку для подключённых ESP-устройств.
• run_pytest: Запускать pytest-тесты с поддержкой embedded pytest для проектов ESP-IDF.

Дополнительные функции:

• Гибкое управление путями ESP-IDF: поддерживает версии ESP-IDF для каждого проекта с помощью параметра idf_path.

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 via install.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_path parameter.
• SDK config management: supports custom sdkconfig_defaults files for build configuration (multiple files can be specified separated by semicolons).
• Build time tracking for performance monitoring.
• Optional port specification for flashing operations.
• Includes experimental support for automatic issue fixing based on build logs.

Vision & Future Work: The long-term vision is to expand this MCP into a comprehensive toolkit for interacting with embedded devices, potentially integrating with home assistant platforms, and streamlining documentation access for ESP-IDF and related technologies.

We envision features such as:

• Broader ESP-IDF command support (e.g., monitor, menuconfig interaction if feasible).
• Device management and information retrieval.
• Integration with other embedded development tools and platforms.

Your ideas and contributions are welcome! Please feel free to discuss them by opening an issue.

Install

First, clone this MCP repository:

git clone [email protected]:horw/esp-mcp.git

Then, configure it in your chatbot.

The JSON snippet below is an example of how you might configure this esp-mcp server within a chatbot or an agent system that supports the Model Context Protocol (MCP). The exact configuration steps and format may vary depending on the specific chatbot system you are using. Refer to your chatbot’s documentation for details on how to integrate MCP servers.

{
    "mcpServers": {
        "esp-run": { // "esp-run" is an arbitrary name you can assign to this server configuration.
            "command": "",
            "args": [