espressif/esp-rainmaker-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

18 stars 13 forks 품질 58 트렌드 22Apache-2.0

Repository Install

ESP RainMaker MCP 서버

개요

이 프로젝트는 esp-rainmaker-cli Python 라이브러리의 모델 Context Protocol (MCP) 서버 래퍼를 제공합니다. MCP 호환 클라이언트 (Cor, Claude Desktop 및 Windsurf와 같은 LLM 또는 애플리케이션과 같은)을 통해 공식 CLI를 사용하여 ESP RainMaker 장치와 상호 작용할 수 있습니다. AI 시스템이 외부 도구, 데이터 소스 및 통합 된 방식으로 상호 작용할 수있는 표준화 된 프레임 워크입니다. Anthropic에 의해 소개되고 주요 AI 조직에 의해 채택해, MCP는 하드웨어를 위한 USB-C 같이 보편적인 공용영역으로, 이음새가 없는 통합을 허용하. - : MCP는 AI 모델을 사용하여 자연 언어 프롬프트를 사용하여 IoT 기기에 액세스하고 제어 할 수 있으며, 더 직관적이고 접근 할 수 있습니다. - : MCP를 통해 사용자는 On/off, Adjusting 설정 및 AI 인터페이스를 통해 일정 관리와 같은 작업을 수행 할 수 있습니다. - : ESP RainMaker MCP 서버는 로컬로 실행하고 기계에 credentials를 저장합니다.

개요(AI 번역)

이 프로젝트는 Model Context Protocol (MCP) 서버 래퍼를 제공합니다. esp-rainmaker-cli] Python 라이브러리. MCP 호환 클라이언트 (Cor, Claude Desktop 및 Windsurf와 같은 LLM 또는 애플리케이션과 같은)을 통해 공식 CLI를 사용하여 ESP RainMaker 장치와 상호 작용할 수 있습니다.

모형 Context 의정서 (MCP)에 소개

**Model Context Protocol (MCP)**는 통합된 방식으로 외부 도구, 데이터 소스, 서비스와 상호 작용할 수 있는 표준화된 프레임워크입니다. Anthropic에 의해 소개되고 주요 AI 조직에 의해 채택해, MCP는 하드웨어를 위한 USB-C 같이 보편적인 공용영역으로, 이음새가 없는 통합을 허용하.

ESP RainMaker의 MCP의 주요 이점

Unified Interaction: MCP는 AI 모델을 사용하여 자연 언어 프롬프트를 사용하여 IoT 기기에 액세스하고 제어할 수 있으며, 더 직관적이고 접근할 수 있습니다.
** 실시간 제어**: MCP를 통해 사용자는 On/off, Adjusting 설정 및 AI 인터페이스를 통해 일정 관리와 같은 작업을 수행 할 수 있습니다.
**Local Server, 클라우드 백업 컨트롤 **: 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 MCP 초보자라면? 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"
         ]
      }
   }
}