hamibot

Hamibot MCP Server 是一个基于 Model Context Protocol（MCP）的实现，用于与 Hamibot API 进行交互。它提供了设备管理、脚本管理、代码执行等工具，允许你列出已连接的设备、查看和运行自动化脚本，以及在指定设备上执行自定义 JavaScript 代码。通过传递变量参数，可以将参数注入到脚本或代码执行过程。要开始使用，请在 Trae 或其他 MCP 客户端中配置 mcpServers 中的 hamibot 条目，并提供你的 HAMIBOT_PERSONAL_ACCESS_TOKEN。配置完成后，你可以通过 MCP 客户端调用以下工具：list-devices、list-scripts、run-script（需要 scriptId、devices、vars）、execute（需要 code、devices、vars）。通过这些工具，你可以实现对 Hamibot 设备的编排与自动化。

准备就绪后，按照以下步骤安装与启动：

1. 安装前提

• 需要安装 Node.js 和 npm（推荐使用 Node.js 14+ 版本）
• 获取 Hamibot 的个人访问令牌（在 Hamibot 账户的 Tokens 页面生成）

2. 设置 MCP 配置

• 打开 Trae（或你使用的 MCP 客户端），选择添加或编辑 mcp.json，粘贴以下配置并替换令牌：

{
  "mcpServers": {
    "hamibot": {
      "command": "npx",
      "args": ["-y", "@hmbt/hamibot-mcp-server"],
      "env": {
        "HAMIBOT_PERSONAL_ACCESS_TOKEN": "你的访问令牌"
      }
    }
  }
}

3. 启动服务器

• 直接在命令行启动（使用 npx）或通过 MCP 客户端导入配置后启动：

npx -y @hmbt/hamibot-mcp-server

4. 验证连接

• 在 MCP 客户端执行 list-devices，确保设备列表能够返回。
• 执行 list-scripts，确认可用的自动化脚本清单。

5. 参考文档

• 其他客户端请参考相应文档以了解特定的集成方式。

提示与注意事项：

• 保护好 HAMIBOT_PERSONAL_ACCESS_TOKEN，避免在公共/共享环境中暴露。
• 该 MCP 服务器通过 npx 运行 Hamibot 的 MCP 服务，确保网络环境允许从 npx 拉取包。
• 若遇到凭证相关错误，请重新生成令牌并更新 mcp.json 中的环境变量。
• 如需自定义变量传递，在 run-script 和 execute 的 vars 字段中添加所需的 Key-Value 对即可。
• 设备和脚本的权限与范围以 Hamibot 账户权限为准，确保令牌具备相应访问能力。