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对您的机器人真空进行精确控制，实现复杂的自动化和语音控制的清洁场景。

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