# 乐鑫 ESP RainMaker

查询和控制物联网设备，设置设备参数并管理自动化日程。

- 类型：MCP
- 权限：可执行操作
- 门槛：需授权账号
- 官方入口：https://mcp.espressif.com/
- 官方仓库：https://github.com/espressif/esp-rainmaker-mcp
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/esp-rainmaker/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

本地部署需 Python 3.10+、uv，并先运行 esp-rainmaker-cli login；账号中应已有设备，MCP 不负责设备配网。远程路径按官网授权。

## 接入步骤

1. 选择官方远程服务并完成客户端授权，或按仓库说明准备本地运行环境。 [官方入口](https://github.com/espressif/esp-rainmaker-mcp)
2. 本地路径先登录 RainMaker CLI 并确认已有设备，再添加对应 MCP 配置。 [官方入口](https://github.com/espressif/esp-rainmaker-mcp)

## 验证方法

查询账号的设备列表并核对名称，不切换电源或修改设备参数。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://mcp.espressif.com/)（核对日期：2026-11-05）

## 安装配置

### 官方服务端点

按用途选择端点，分别核对官方认证方式、地域及权限要求。

- RainMaker：https://mcp.rainmaker.espressif.com/api/mcp — 管理 RainMaker 设备；按官方说明完成账户授权
- 乐鑫文档：https://mcp.espressif.com/docs — 检索乐鑫文档；每用户每小时 40 次、每日 200 次
- 组件注册表：https://components.espressif.com/mcp — 搜索 ESP-IDF 组件与示例；独立服务，按官方说明接入
- ESP-VISION：https://mcp.vision.espressif.com — 查询视觉开发 API；独立服务，按官方说明接入
- 工程技术支持：https://ts-mcp.espressif.com/mcp — 乐鑫工程技术支持；独立服务，按官方说明接入
- ESP Pilot：https://mcp.esp-pilot.espressif.com/mcp — ESP 多媒体应用开发；独立服务，按官方说明接入

### JSON

```
{
  "mcpServers": {
    "esp-rainmaker": {
      "type": "http",
      "url": "https://mcp.rainmaker.espressif.com/api/mcp"
    }
  }
}
```

### Claude Code

```
claude mcp add --transport http 'esp-rainmaker' 'https://mcp.rainmaker.espressif.com/api/mcp'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.esp-rainmaker]
url = "https://mcp.rainmaker.espressif.com/api/mcp"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://mcp.espressif.com/)。乐鑫官方 MCP 门户列出 RainMaker 远程服务与设备读写能力。

官方原文摘录（2026-11-05，来自上述依据）：

```
https://mcp.rainmaker.espressif.com/api/mcp
```

- [厂商官方接入文档](https://github.com/espressif/esp-rainmaker-mcp)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)