Valetudo MCP - LLM Control for Robot Vacuums
2025.05.05
0
C#智能家居自动化控制机器人吸尘器智能家居自动化控制
Valetudo MCP 是一个专门的服务，旨在通过大型语言模型（LLMs）控制支持 Valetudo 的机器人吸尘器。该项目连接了对话式 AI 和智能家居自动化，允许 AI 助手通过自然语言命令执行吸尘器操作。
View on GitHub
Overview
产品定位
Valetudo MCP 是一个桥梁，将大型语言模型（LLMs）与智能家居设备（特别是机器人吸尘器）连接起来，实现通过自然语言控制设备的功能。
核心功能
- LLM 驱动的吸尘器控制：通过简洁的 API 接口让 AI 模型控制机器人吸尘器。
- Valetudo 集成：与 Valetudo（机器人吸尘器的无云控制软件）无缝协作。
- 多种操作模式：支持 stdio 模式（直接与 LLM 应用集成）和 HTTP/SSE 模式（基于网络的访问）。
适用场景
- 通过自然语言命令控制机器人吸尘器。
- 集成到智能家居自动化流程中。
- 与 AI 助手（如 Claude Desktop、Anything-LLM）结合使用。
工具列表
| 工具名称 | 描述 |
|---|---|
get-map-segments |
获取机器人吸尘器可清洁的区域，返回带有名称和对应 ID 的段列表。 |
clean-map-segments |
强制机器人吸尘器清洁定义的段，需要通过 get-map-segments 工具获取段 ID。 |
clean-all |
强制机器人吸尘器清洁整个地图（公寓或房屋）或恢复当前清洁。 |
stop-cleaning |
强制机器人吸尘器停止当前清洁操作。 |
pause-cleaning |
强制机器人吸尘器暂停当前清洁操作。 |
go-home |
强制机器人吸尘器返回充电站。如果遇到错误，请先尝试使用 stop-cleaning。 |
常见问题解答
- 如何配置机器人 URI？：通过环境变量
ValetudoMcp__RobotUri设置机器人 URL。 - 支持哪些服务器模式？：支持 "Stdio" 和 "http" 两种模式。
- 是否需要认证？：如果需要，可以通过
ValetudoMcp__Username和ValetudoMcp__Password设置用户名和密码。
使用教程
使用依赖
确保已安装 Docker。
安装教程
Stdio 模式（适用于 Claude Desktop、Anything-LLM 等）
{
"mcpServers": {
"vacuum-robot": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ValetudoMcp__RobotUri",
"-e",
"ValetudoMcp__ServerType",
"nihfix/valetudo.mcp",
"--access-mode=unrestricted"
],
"env": {
"ValetudoMcp__RobotUri": "http://192.168.1.12",
"ValetudoMcp__ServerType": "Stdio"
}
}
}
}
HTTP/SSE 模式（适用于 Web 集成，如 n8n）
docker run -i --rm \
-e ValetudoMcp__RobotUri="http://192.168.1.12" \
-e ValetudoMcp__ServerType=http \
-p 3005:8080 \
nihfix/valetudo.mcp
调试方式
- SSE 端点：
http://localhost:3005/sse - 可流式协议端点：
http://localhost:3005/