espidf MCP

MCP运维云端

提供方 Aaron-xx

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

符合MCP标准的ESP-IDF开发运维服务器,通过stdio或HTTP提供ESP-IDF工具接口,支持多协议、双格式日志、错误诊断和性能监控。

一句话选型结论

按资料字段整理

espidf MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

开发运维Python本地部署ESP-IDF工具MCP标准错误诊断性能监控

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
espidf MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Aaron-xx上游标注的维护方 Aaron-xx
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.6 KB
来自项目仓库与上游目录的原文,未做删改

ESP-IDF MCP Server

符合 MCP 标准的 ESP-IDF 开发运维服务器,通过 stdio 或 HTTP 提供 ESP-IDF 工具接口。

特性

  • MCP 标准兼容: 完全符合 Model Context Protocol 标准
  • 多协议支持: 支持 stdio(MCP 客户端)和 HTTP/SSE(URL 访问)
  • 双格式日志: 彩色终端输出 + JSON 结构化日志(AI 友好)
  • 错误诊断: 智能错误模式识别和修复建议
  • 性能监控: 工具执行统计和瓶颈分析
  • 简单优先: 极简模块结构,易于维护
  • 基于现有设施: 复用 idf.py 和现有命令行工具
  • 友好输出: 人类可读的文本格式,带 emoji 标识
  • 安全优先: 不执行破坏性操作
  • 自动检测: 自动检测 ESP-IDF 项目目录

快速开始

全局安装```bash

cd /path/to/espidf-mcp
pip install -e .


### 使用方式

**方式 1: 全局命令(推荐)**```bash
# 进入 ESP-IDF 项目目录
cd /path/to/esp32_project

# 启动服务器(stdio 模式)
espidf-mcp

# 启动服务器(HTTP 模式)
espidf-mcp --http --port 8090

方式 2: Python 模块```bash

进入 ESP-IDF 项目目录

cd /path/to/esp32_project

启动服务器(stdio 模式)

python -m espidf_mcp

启动服务器(HTTP 模式)

python -m espidf_mcp --http --port 8090


### 项目自动检测

服务器会自动检测当前目录是否为 ESP-IDF 项目:

- ✅ **有效项目**: 显示项目信息,正常启动
- ⚠️ **无效项目**: 显示警告和建议,仍然启动服务器(工具会返回错误)

检测逻辑:
1. 检查是否存在 `CMakeLists.txt`
2. 验证 `CMakeLists.txt` 内容包含 ESP-IDF 标记

### 客户端配置

在 MCP 客户端配置文件中添加(如 Claude Desktop):```json
{
"mcpServers": {
"espidf": {
"command": "espidf-mcp",
"cwd": "/path/to/esp32_project",
"env": {
"IDF_PATH": "/path/to/esp-idf"
}
}
}
}

更多示例配置见 examples/mcp-client-config.json

可用工具

核心 ESP-IDF 工具

工具 说明
esp_project_info 获取当前项目信息
esp_build 构建 ESP-IDF 项目
esp_flash 烧录固件到设备
esp_monitor 实时监控串口输出
esp_list_ports 列出可用的串口设备
esp_clean 清理构建文件
esp_fullclean 完全清理构建文件
esp_size 分析固件大小
esp_set_target 设置芯片目标

可观测性工具

工具 说明
esp_metrics_summary 获取工具性能指标(执行次数、成功率、平均耗时)
esp_observability_status 获取可观测性系统状态和健康检查
esp_logs_view 查看最近的日志条目(支持级别过滤)
esp_error_history 获取最近的错误历史和诊断信息
esp_diagnose_last_error 获取最近错误的诊断建议

使用示例

构建 ESP-IDF 项目```json

{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "esp_build",
"arguments": {}
}
}


### 监控串口输出```json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "esp_monitor",
"arguments": {
"port": "/dev/ttyUSB0",
"seconds": 30
}
}
}

烧录固件```json

{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "esp_flash",
"arguments": {
"port": "/dev/ttyUSB0",
"baud": 460800
}
}
}


## 工具参数详情

### esp_project_info

获取当前项目信息

无参数

### esp_build

构建 ESP-IDF 项目(在当前目录)

无参数

### esp_flash

烧录固件到设备

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| port | string | ❌ | 串口设备(默认自动检测) |
| baud | int | ❌ | 波特率(默认: 460800) |

### esp_monitor

实时监控串口输出

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| port | string | ✅ | 串口设备(如 /dev/ttyUSB0) |
| baud | int | ❌ | 波特率(默认: 115200) |
| seconds | int | ❌ | 监控时长,秒(默认: 60) |

### esp_list_ports

列出可用的串口设备

无参数

### esp_clean / esp_fullclean

清理/完全清理构建文件

无参数

### esp_size

分析固件大小

无参数

### esp_set_target

设置芯片目标

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| target | string | ✅ | 芯片型号(esp32, esp32s2, esp32c3, esp32s3, esp32c2, esp32h2, esp32p4, esp32c6, esp32c5) |

## 可观测性

ESP-IDF MCP Server 内置了可观测性系统,提供双格式日志、性能监控和错误诊断功能。

### 日志系统

日志存储在 `.espidf-mcp/logs/` 目录:```
.espidf-mcp/
├── logs/
│   ├── workflow.log          # 人类可读日志
│   ├── structured/           # JSON 结构化日志
│   │   ├── espidf_mcp.jsonl  # 主服务器日志
│   │   └── workflow.jsonl    # 工作流日志
│   └── archive/              # 日志轮转备份

特性:
- 彩色终端输出(INFO=绿色, WARNING=黄色, ERROR=红色)
- JSONL 格式结构化日志(AI 友好)
- 自动日志轮转(10MB,保留 5 个备份)

错误诊断

系统内置 15+ 种常见错误模式识别:

错误类型 模式 建议
环境错误 IDF_PATH not set source ~/esp/esp-idf/export.sh
构建错误 region.*overflow 减少组件大小,检查分区表
硬件错误 Failed to connect 检查 USB 连接,检查串口权限
烧录错误 Failed to write 降低波特率,检查 USB 线质量

工具参数详情

esp_metrics_summary

获取工具性能指标摘要

参数 类型 必填 说明
tool_name string ❌ 指定工具名称(空则返回所有)

返回:调用次数、成功率、平均耗时、最后调用时间

esp_observability_status

获取可观测性系统状态和健康检查

无参数

返回:日志文件状态、指标收集状态、诊断引擎状态

esp_logs_view

查看最近的日志条目

参数 类型 必填 说明
level string ❌ 日志级别(DEBUG/INFO/WARNING/ERROR,默认: INFO)
tail int ❌ 返回最近条目数(默认: 50)

esp_error_history

获取最近的错误历史和诊断信息

参数 类型 必填 说明
count int ❌ 返回错误条数(默认: 10)

esp_diagnose_last_error

获取最近错误的诊断建议

无参数

返回:匹配的错误模式、修复建议、严重级别

环境要求

  • Python 3.10+
  • ESP-IDF 环境已配置(需先 source export.sh)
  • pyserial(用于串口操作)

开发安装

安装开发依赖```bash

pip install -e ".[dev]"


### 运行测试```bash
pytest tests/ -v

测试覆盖率```bash

pytest tests/ --cov=espidf_mcp --cov-report=html


## 依赖项

### 生产依赖```
fastmcp>=2.14.2
mcp>=1.10.0
pyserial>=3.5

开发依赖```

pytest>=8.0.0
pytest-cov>=4.1.0
pytest-asyncio>=0.23.0
pytest-mock>=3.14.0


## 技术栈

- **FastMCP**: MCP 服务器框架
- **MCP**: Model Context Protocol SDK
- **PySerial**: 串口操作库

## 文件结构```
espidf-mcp/
├── pyproject.toml          # 项目配置和元数据
├── README.md               # 使用说明
├── LICENSE                 # MIT 许可证
├── MANIFEST.in             # 打包清单
│
├── espidf_mcp/             # Python 包
│   ├── __init__.py         # 包初始化
│   ├── __main__.py         # Python 模块入口
│   ├── cli.py              # CLI 命令入口
│   ├── server.py           # MCP 服务器核心
│   ├── project.py          # 项目检测模块
│   │
│   ├── observability/      # 可观测性模块
│   │   ├── __init__.py     # 公共 API
│   │   ├── logger.py       # 双格式日志系统
│   │   ├── metrics.py      # 性能指标收集
│   │   ├── diagnostics.py  # 错误诊断引擎
│   │   └── formatters.py   # 输出格式化
│   │
│   └── workflow/           # 工作流管理(可选)
│       ├── file_state.py   # 文件状态管理
│       └── manager.py      # 工作流编排器
│
├── tests/                  # 测试套件
│   ├── conftest.py         # pytest 配置
│   ├── test_server.py      # 服务器测试
│   ├── test_tools.py       # 工具测试
│   ├── test_e2e.py         # 端到端测试
│   └── test_observability.py # 可观测性测试
│
└── examples/               # 示例配置
└── mcp-client-config.json

安全说明

  • 不执行破坏性操作(如格式化 eFuse)
  • 需要正确配置 ESP-IDF 环境
  • 建议在受信任的网络环境中使用

License

MIT License

贡献

欢迎提交 Issue 和 Pull Request!

更新日志

v0.2.0 (2025-01-11)

  • ✨ 新增可观测性系统
  • 双格式日志:彩色终端输出 + JSON 结构化日志
  • 性能监控:工具执行统计和瓶颈分析
  • 错误诊断:15+ 种常见错误模式识别
  • ✨ 新增 5 个可观测性 MCP 工具
  • esp_metrics_summary - 性能指标查询
  • esp_observability_status - 系统状态检查
  • esp_logs_view - 日志查看器
  • esp_error_history - 错误历史查询
  • esp_diagnose_last_error - 错误诊断建议
  • ✨ 完整的可观测性测试覆盖(31 个测试用例)
  • ✨ 工作流状态管理增强

v0.1.0 (2025-01-09)

  • ✨ 首次发布
  • ✨ 支持全局安装和命令行工具
  • ✨ 自动检测 ESP-IDF 项目
  • ✨ 友好的错误提示和建议
  • ✨ 9 个 MCP 工具
  • ✨ 完整的测试覆盖

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
espidf MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

espidf MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

espidf MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

espidf MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

espidf MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

espidf MCP 能提供哪些能力?

资料显示能力标签包括 Python、Claude、性能监控。具体工具清单以官方文档为准。

espidf MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

espidf MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。