Tuya Robot Map

Appearance

MCP ​

为 AI 助手集成地图分析工具。

安装 (Installation) ​

Cursor (一键安装) ​

Cursor 用户可以通过点击下方按钮直接安装 MCP 服务：

安装 MCP 服务

Claude Code ​

要在 Claude Code 中添加此服务，请使用 mcp add 指令。建议显式指定 stdio 传输模式：

bash
claude mcp add --transport stdio ray-robot-map-analyzer -- npx -y -p @ray-js/robot-map-sdk@latest robot-map-analyzer

提示

如果您希望在所有项目中都能使用该工具（不仅限于当前目录），可以添加 --scope user 参数。

Antigravity ​

对于 Antigravity 用户，请使用 --add-mcp 指令并传入 JSON 配置：

bash
antigravity --add-mcp '{"name": "ray-robot-map-analyzer", "command": "npx", "args": ["-y", "-p", "@ray-js/robot-map-sdk@latest", "robot-map-analyzer"]}'

环境要求 ​

  • Node.js >= 16
  • 网络连接（用于通过 npx 实时获取最新版 npm 包）

使用 (Usage) ​

最佳实践 (Best Practices) ​

为了获得最稳定的分析体验，建议遵循以下交互模式：

1. 优先使用文件引用 (推荐) ​

当您需要分析复杂的地图或长路径时，不要直接粘贴 Hex 字符串。请先将数据存为本地文件，然后在提问时提及该文件。

操作示例：

  1. 在终端运行：pbpaste > map.hex (将剪贴板内容存入文件)
  2. 向 AI 提问：“请分析一下当前目录下 map.hex 这个文件的地图概况。”

AI 会识别到路径并自动调用工具的 path 参数进行处理，这样可以完全避免因 Hex 字符串过长导致的对话中断。

2. 常见提问示例 ​

您可以尝试以下提问方式：

  • “帮我分析一下 map.hex 的概要信息。”
  • “结合 map.hex 和 path.hex，告诉我机器人现在在哪个房间？离充电桩有多远？”
  • “这个地图里有多少个房间？分布状况如何？”
  • “为什么 map.hex 右上角的障碍物有交错重叠的现象？”
  • “分析一下 path.hex 里的清扫路径轨迹。”

大数据处理指引 ​

由于扫地机地图和路径数据（Hex）通常非常庞大，直接在聊天框中粘贴大数据可能导致 AI 响应中断或 Token 溢出。

  1. 存为文件：建议将 Hex 数据保存为本地文件（如 map.hex 或 path.hex）。
  2. 文件分析：直接告知 AI 文件绝对路径，它将优先使用工具的 path 参数进行静默读取分析。
  3. 支持 Hex：对于较小的数据（如 DP 命令），仍可直接粘贴进行分析。