简介

一个控制服务器，通过MCP协议使AI助手能够与Ecovacs扫地机器人交互，支持设备列表、清洁控制、充电控制和状态查询。

简介

一个控制服务器，通过MCP协议使AI助手能够与Ecovacs扫地机器人交互，支持设备列表、清洁控制、充电控制和状态查询。

Sweeping Robot Control MCP Server

English | Chinese

Ecovacs core APIs are now fully compatible with the MCP protocol, making Ecovacs the world's first robot service provider to support the MCP protocol.

Ecovacs has completed the integration of 4 core API interfaces with the MCP protocol, including device list query, cleaning control, recharging control, and working status query.

As the world's first cleaning robot service provider supporting the MCP protocol, after the release of the Ecovacs MCP Server, intelligent agent developers only need simple configurations to quickly integrate robot services into large models, achieving capabilities such as querying, cleaning, and recharging.

This significantly lowers the barrier for calling robot control services during the development process of intelligent agent applications, greatly improving the efficiency of application development.

Tools

Device List Query

Obtain a list of all robots bound by the user.

Input:

No parameters

Returns:

json { "status": 0, "message": "success", "data": [ { "nickname": "Robot Nickname", } ] }

Start Cleaning

Control the sweeping robot to start, pause, resume, or stop cleaning.

Input:

• nickname: The nickname of the robot, used to find the device. Supports fuzzy matching.
• act: Cleaning action
  • s: Start cleaning
  • r: Resume cleaning
  • p: Pause cleaning
  • h: Stop cleaning

Returns:

json { "msg": "OK", "code": 0, "data": [] }

Recharge Control

Control the robot to start or stop recharging.

Input:

• nickname: The nickname of the robot, used to find the device.
• act: Robot action
  • go-start: Start recharging
  • stopGo: Stop recharging

Returns:

json { "msg": "OK", "code": 0, "data": [] }

Query Working Status

Query the current working status of the robot.

Input:

• nickname: The nickname of the robot, used to find the device.

Returns:

json { "code": 0, "msg": "success", "data": { "ctl": { "data": { "ret": "ok", "cleanSt": "h", "chargeSt": "charging", "stationSt": "i" } } } }

Status Code Explanation:

Getting Started

Installation

Local Installation via GitHub

bash git clone git@github.com:ecovacs-ai/ecovacs-mcp.git

uv add "mcp[cli]" mcp requests

uv run ecovacs_mcp/robot_mcp_stdio.py

Via PyPI

pip install ecovacs-robot-mcp

python3 -m ecovacs_robot_mcp

Environment Variables

• ECO_API_KEY: API access key, used to verify interface call permissions.
• ECO_API_URL: API HOST
  • Mainland China: https://open.ecovacs.cn
  • Non-Mainland China: https://open.ecovacs.com

Obtain AK & Delete AKBefore choosing between the two methods (local or SSE), you need to create a server-side AK in the Ecovacs Open Platform console. Only with the AK can you call the robot's API capabilities.

If you want to revoke authorization, you can also remove the AK authorization in the Ecovacs Open Platform console.

Ecovacs Open Platform (Mainland China): https://open.ecovacs.cn

Ecovacs Open Platform (Non-Mainland China): https://open.ecovacs.com

Configuration

Add the following configuration in any MCP client (e.g., Claude.app). Some clients may require formatting adjustments.

Where ECO_API_KEY is the API access key and ECO_API_URL is the API HOST.

• Using uvx json { "mcpServers": { "ecovacs_mcp": { "command": "uvx", "args": ["ecovacs-robot-mcp"], "env": { "ECO_API_KEY": "your AK...........", "ECO_API_URL": "https://open.ecovacs.cn" // For non-Mainland China, configure as https://open.ecovacs.com } } } }

• Using pip installation

json { "mcpServers": { "ecovacs_mcp": { "command": "python", "args": ["-m", "ecovacs-robot-mcp"], "env": { "ECO_API_KEY": "your AK...........", "ECO_API_URL": "https://open.ecovacs.cn" // For non-Mainland China, configure as https://open.ecovacs.com } } } }

Usage Example (Claude Example)

Open the Settings in Claude for Desktop, switch to Developer, click Edit Config, and open the configuration file with any IDE.

Add the following configuration to the configuration file. ECO_API_KEY is the AK for accessing the Ecovacs Open Platform API, which can be obtained from this page:

json { "mcpServers": { "ecovacs_mcp": { "command": "python3", "args": ["-m", "ecovacs_robot_mcp"], "env": { "ECO_API_KEY": "your ak......", "ECO_API_URL": "https://open.ecovacs.cn" // For non-Mainland China, configure as https://open.ecovacs.com } } } }

Restart Claude. At this point, the settings panel has successfully loaded the Ecovacs Robot MCP Server. In the main interface of the software, you can see 4 available MCP tools; click to view details.

Effect

You can now start asking questions to verify the capabilities of the Ecovacs robot assistant.

Usage Example (Cursor Example)

Enter Cursor Settings to Configure SSE Connection

Add a New MCP Server Configuration

• Mainland China json { "mcpServers": { "robot_control_server": { "url": "https://mcp-open.ecovacs.cn/sse?ak=your ak" // For regions outside Mainland China, configure as https://mcp-open.ecovacs.com/sse?ak=your ak } } }

• Non-Mainland China json { "mcpServers": { "robot_control_server": { "url": "https://mcp-open.ecovacs.com/sse?ak=your ak" } } }

Return to Cursor Settings to Check MCP Service Tool Status

Select a Cursor Large Model for a Better Service Experience, Recommend Choosing claude-3.7-sonnet

Interaction Mode: Choose Agent Mode

Effect

License

MIT © ecovacs

Feedback

If you encounter any issues while using the Ecovacs Robot MCP Server, feel free to reach out via issue or contact us. We also welcome every positive PR. Thank you very much for your support and contributions ❤️

Contact Information

Mail: pei.zhou@ecovacs.com

Wechat:

Updates

服务配置

[{'mcpServers': {'robot_control_server': {'url': 'https://mcp-open.ecovacs.com/sse?ak=your ak'}}}]

来源

• 来源：github
• 链接：https://github.com/ecovacs-ai/ecovacs-mcp