Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-10-02 03:00:34 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'feat/mcp_server_accept_project_dir_v6.0' into 'release/v6.0'

Browse Source 
feat(tools): mcp-server accepts project_dir from chat (v6.0)

See merge request espressif/esp-idf!50033
This commit is contained in:
Roland Dobai
2026-06-29 07:37:09 +02:00
parent c97a957d3b 75f5ddfd44
commit 100484f2da
5 changed files with 838 additions and 70 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/zh_CN/api-guides/tools/idf-py.rst
+6 -3
View File
@@ -283,7 +283,7 @@ ESP-IDF 的 MCP（Model Context Protocol，模型上下文协议）服务器可
eim run "idf.py mcp-server"
2. 直接使用 ``idf.py``：在已激活 ESP-IDF 环境的 shell 中运行 ``idf.py mcp-server`` 命令启动 MCP 服务器。必须在有效的 ESP-IDF 项目目录中执行该命令，或者使用 ``idf.py -C <project_dir> mcp-server`` 指定项目路径。
2. 直接使用 ``idf.py``：在已激活 ESP-IDF 环境的 shell 中运行 ``idf.py mcp-server`` 命令启动 MCP 服务器。该服务器可以在任何目录下启动。使用 ``idf.py -C <project_dir> mcp-server`` 或设置 ``IDF_MCP_WORKSPACE_FOLDER`` 环境变量来配置默认项目。如果在启动时未配置任何项目，则在每次调用工具时显式传递项目目录。
.. code-block:: bash
@@ -296,12 +296,15 @@ ESP-IDF 的 MCP（Model Context Protocol，模型上下文协议）服务器可
可用工具与资源
^^^^^^^^^^^^^^
MCP 服务器提供以下可用的命令：
MCP 服务器提供以下工具：
- ``set target``：设置 ESP-IDF 的目标芯片（esp32，esp32s3，esp32c6 等）
- ``build project``：使用当前目标构建 ESP-IDF 项目
- ``flash project``：将已构建的项目烧录到已连接的设备，通过端口名称进行指定。
- ``flash project``：将已构建的项目烧录到已连接的设备，通过端口名称进行指定
- ``clean project``：清理构建产物
- ``create project``：基于示例模板创建新的 ESP-IDF 项目，可在尚无项目时使用
所有工具都接受可选的 ``project_dir`` 参数。当省略该参数时，工具将默认使用启动时配置的目录（该目录可通过 ``-C`` 参数或 ``IDF_MCP_WORKSPACE_FOLDER`` 环境变量指定）。你可以要求 AI 模型明确指定某个项目目录，例如当同时处理多个项目，或启动时未配置默认项目的情况下。
同时提供以下资源：