AI导哈

机器人吸尘器LLM控制服务

Valetudo MCP是一个专门的服务，使大型语言模型（LLM）能够通过自然语言命令控制Valetudo驱动的机器人吸尘器，实现智能家居自动化与AI助手的无缝集成。

  • by AlekseyKapustyanenko
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 alekseykapustyanenko/nihfix.valetudo.mcp

使用说明

Valetudo MCP-LLM机器人真空控制

Valetudo MCP是一个专用服务器，它使大型语言模型（LLM）能够控制您的Valetudo-powered机器人真空。该项目弥合了对话式人工智能和智能家居自动化之间的差距，允许人工智能助手通过自然语言命令执行真空操作。

特性

  • LLM动力真空控制：使人工智能模型能够通过干净的API界面控制机器人真空
  • Valetudo集成：与无缝协作 有效性，机器人吸尘器的无云控制软件
  • 多种操作模式：以stdio模式运行以直接集成LLM，或以HTTP/SSE模式运行以基于web的访问

使用模式

标准模式（适用于克劳德桌面、任何LLM等）

非常适合与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", // your robot url
        "ValetudoMcp__ServerType": "Stdio"
      }
    }
  }
}

HTTP/SSE模式（适用于n8n等Web集成）

作为独立服务器运行，为HTTP和服务器发送事件公开端点：

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/

配置

环境变量 描述
ValetudoMcp__RobotUri Valetudo电动机器人的URL（必填）
ValetudoMcp__ServerType 服务器模式：“Stdio”或“http”
ValetudoMcp__Username 机器人身份验证的用户名（如果需要）
ValetudoMcp__Password 机器人身份验证密码（如果需要）

可用工具

服务器提供了一套丰富的真空控制工具：

工具名称 描述
get-map-segments 为真空机器人提供可用的清洁区域。返回一个包含名称和相应ID的段列表。
clean-map-segments 强制真空机器人清洁指定区域。需要可以通过获取地图分段工具获得的分段ID。
clean-all 强制真空机器人清洁整个地图（公寓、公寓或房子）或恢复当前的清洁。
stop-cleaning 强制真空机器人停止其当前的清洁操作。
pause-cleaning 强制真空机器人暂停其当前的清洁操作。
go-home 强制真空机器人返回其充电站。如果遇到错误，请先尝试使用停止清洁。

这些工具允许LLM对您的机器人真空进行精确控制，实现复杂的自动化和语音控制的清洁场景。

通过将您的人工智能助手直接连接到您的机器人吸尘器，体验下一级的智能家居自动化！

相关 MCP