Valetudo MCP

Valedict MCP

基于Go-based的MCP服务器，用于通过Valetudo HTTP API与Valetudo驱动的机器人真空吸尘器进行交互。

特性

• 获取机器人的当前状态（属性、地图）
• 获取机器人基本信息（制造商、型号、实施）
• 获取机器人支持的功能列表
• 设置Valetudo日志级别（跟踪、调试、信息、警告、错误）
• 控制机器人的基本功能（启动、停止、暂停、返回）
• 找到机器人（播放声音以帮助找到它）
• 区域清洁（清洁家中的特定区域）

需求

• 转到1.24+
• 机器人真空运行 Valeditudo （具有可访问的HTTP API）

设置

请随时从下载最新版本 发布页面. 确保设置 VALETUDO_URL 将环境变量添加到Valetudo实例基URL。

如果你想自己构建它，你可以通过以下步骤来实现：

1. 克隆此存储库：

   git clone https://github.com/niclaszll/valetudo-mcp.git
   cd valetudo-mcp

1. 设置 VALETUDO_URL Valetudo实例基URL的环境变量：

   export VALETUDO_URL="http://:
"

1. 构建并运行：

   go build -o valetudo-mcp
   ./valetudo-mcp

1. 将其与您选择的MCP兼容主机集成，如Claude Desktop或Cursor。

用法

MCP服务器将启动并注册以下工具：

• get_robot_state：获取机器人的当前状态
• get_robot_info：获取机器人基本信息
• get_robot_capabilities：获取机器人支持的功能列表
• set_log_level：设置Valetudo日志级别
• basic_control：控制基本机器人功能
• locate：播放声音以帮助定位机器人
• zone_clean：清洁家中的特定区域

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

归因

该项目使用 Valeditudo API被机器人真空暴露。Valetudo是一个开源项目，可以实现机器人吸尘器的本地控制。API及其开发的所有功劳都归功于Valetudo的贡献者。