espressif/esp-rainmaker-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

18 stars 13 forks 质量 58 趋势 22Apache-2.0

Repository Install

ESP RainMaker MCP 服务器

概览

这个项目提供了一个模型背景协议(MCP)服务器包装器,环绕esp-rainmaker-cli Python库. 它允许MCP相容客户端(如LLMS或Cursor,克洛德桌面等应用程序和Windsurf)使用官方的CLI与你的ESP RainMaker设备交互. 这是一个标准化的框架,使AI系统能够以统一的方式与外部工具,数据源,服务互动. 由Anthropic推出并被主要AI组织所采用,MCP作为通用接口,与硬件的USB-C很像,允许不同平台的无缝集成. -:MCP允许AI模型使用自然语言的提示来访问和控制IOT设备,使交互更加直观和方便. - 说吧通过MCP,用户可以执行打开/关闭设备,调整设置等动作,并通过AI接口直接管理调度. - : ESP RainMaker MCP服务器在本地运行,并在您的机器上存储证书.

概述（AI 翻译）

这个项目提供了一个“[T0]”周围的“模式上下文协议”服务器包 Python 图书馆. 它允许MCP相容客户端(如LLMS或Cursor,克洛德桌面等应用程序和Windsurf)使用官方的CLI与你的ESP RainMaker设备交互.

□ 示范背景协议介绍(MCP)

** 模式背景协议**是一个标准化框架,使AI系统能够与外部工具、数据源和服务统一互动。由Anthropic推出并被主要AI组织所采用,MCP作为通用接口,与硬件的USB-C很像,允许不同平台的无缝集成.

MCP在ESP RainMaker的主要效益

** 统一交互**:MCP允许AI模型使用自然语言提示来访问和控制IOT设备,使交互更加直观和方便.
** 实时控制**: 通过MCP,用户可以执行打开/关闭设备,调整设置等动作,并通过AI接口直接管理调度.
** 本地服务器,云端控制器**: ESP RainMaker MCP服务器在当地运行,并在您的机器上存储证书.

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

ESP RainMaker MCP Server

This project provides a Model Context Protocol (MCP) server wrapper around the esp-rainmaker-cli Python library. It allows MCP-compatible clients (like LLMs or applications such as Cursor, Claude Desktop, and Windsurf) to interact with your ESP RainMaker devices using the official CLI.

Introduction to Model Context Protocol (MCP)

The Model Context Protocol (MCP) is a standardized framework that enables AI systems to interact with external tools, data sources, and services in a unified manner. Introduced by Anthropic and adopted by major AI organizations, MCP acts as a universal interface, much like USB-C for hardware, allowing seamless integration across different platforms.

Key Benefits of MCP in ESP RainMaker

Unified Interaction: MCP allows AI models to access and control IoT devices using natural language prompts, making interactions more intuitive and accessible.
Real-time Control: With MCP, users can execute actions such as turning devices on/off, adjusting settings, and managing schedules directly through AI interfaces.
Local Server, Cloud-Backed Control: The ESP RainMaker MCP server runs locally and stores credentials on your machine. However, device management actions are performed via the official ESP RainMaker cloud APIs through the esp-rainmaker-cli.

By integrating MCP, the ESP RainMaker platform enhances its capabilities, allowing tools like Claude, Cursor, Windsurf, and Gemini CLI to manage IoT devices efficiently and securely.

Prerequisites

Python: Version 3.10 or higher
uv: The uv Python package manager. Install from Astral’s uv documentation.
ESP RainMaker CLI Login: You must have successfully logged into ESP RainMaker using the standard esp-rainmaker-cli login command in your terminal at least once. This server relies on the credentials saved by that process.
RainMaker Nodes added into your account since onboarding isn’t supported by the MCP server.

Installation & Setup

Clone the Repository:

git clone https://github.com/espressif/esp-rainmaker-mcp.git
cd esp-rainmaker-mcp

Install Dependencies using uv: This command installs esp-rainmaker-cli, mcp[cli], and any other dependencies listed in pyproject.toml into a virtual environment managed by uv.
```
uv sync
```
(This assumes uv is installed)
Login to ESP Rainmaker using esp-rainmaker-cli
```
uv run esp-rainmaker-cli login
```

[!NOTE] Direct login via username/password within MCP is not supported for security reasons. Please use the standard CLI login flow first.

Client Configuration

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
   "mcpServers": {
      "ESP-RainMaker-MCP": {
         "command": "uv",
         "args": [
            "run",
            "--with",
            "esp-rainmaker-cli",
            "--with",
            "mcp[cli]",
            "mcp",
            "run",
            "<absolute_path_to_repo>/server.py"
         ]
      }
   }
}