Ecovacs MCP Server

作为全球首家支持MCP协议的清洁机器人服务商,科沃斯MCP Server发布后,智能体开发者仅需简单配置,就可以在大模型中快速接入机器人服务,实现查询、清扫、回充等能力。

Local serverstdioPython

What is the Ecovacs MCP MCP server?

Most developer tooling work still happens through a UI a human drives. Ecovacs MCP MCP server moves it into the conversation instead. 作为全球首家支持MCP协议的清洁机器人服务商,科沃斯MCP Server发布后,智能体开发者仅需简单配置,就可以在大模型中快速接入机器人服务,实现查询、清扫、回充等能力。.

The tools it exposes

The server publishes 11 tools. What each one is for:

  • nickname — 机器人的昵称,用于查找设备,支持模糊匹配
  • act — 清扫行为
  • go-start — 开始回充
  • stopGo — 结束回充
  • ECO_API_KEY — API访问密钥,用于验证接口调用权限
  • ECO_API_URL — API HOST
  • cleanSt — string
  • chargeSt — string
  • stationSt — string
  • V1.0 — Ecovacs MCP Server正式上线
  • pipy — The pipy tool exposed by this server

Getting it running

Installation goes through your MCP client rather than a global install: point it at ecovacs-robot-mcp on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: ECO_API_KEY, ECO_API_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Ecovacs MCP's toolset — nickname, act, go-start and 8 more — is a fair guide to whether it matches your workflow. It is maintained by ecovacs-ai; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Ecovacs MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Ecovacs MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
nickname机器人的昵称,用于查找设备,支持模糊匹配
act清扫行为
go-start开始回充
stopGo结束回充
ECO_API_KEYAPI访问密钥,用于验证接口调用权限
ECO_API_URLAPI HOST
cleanStstring
chargeStstring
stationStstring
V1.0Ecovacs MCP Server正式上线
pipyThe pipy tool exposed by this server.

How to install the Ecovacs MCP MCP server

{
  "mcpServers": {
    "ecovacs_mcp": {
      "command": "uvx",
      "args": ["ecovacs-robot-mcp"],
      "env": {
        "ECO_API_KEY": "your AK...........",
        "ECO_API_URL": "https://open.ecovacs.cn" // 如果是非中国内地,配置为 https://open.ecovacs.com
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
ECO_API_KEYCredential the server authenticates with.Yes
ECO_API_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Ecovacs MCP to nickname.
  • Use Ecovacs MCP to act.
  • Use Ecovacs MCP to go-start.

Frequently asked questions

It connects Ecovacs MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (nickname, act, go-start, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Ecovacs MCP directly.