🤖 Hamibot MCP 服务器

Hamibot MCP 服务器是基于模型上下文协议（MCP）实现的一个服务器，用于与 Hamibot API 进行交互。它提供了一系列工具来管理和控制 Hamibot 设备和脚本。

✨ 特性

• 设备管理：列出所有已连接的设备
• 脚本管理：查看并运行自动化脚本
• 代码执行：在指定设备上执行自定义的 JavaScript 代码
• 支持变量传递：可以向脚本传递自定义参数

⚙️ 配置

访问令牌

1. 访问 https://hamibot.com/account/tokens
2. 点击生成

在 Trae 中使用

请参阅 Trae 文档中的详细步骤：https://docs.trae.ai/ide/model-context-protocol?_lang=zh

1. 按下按钮 F1
2. 输入 open mcp config json 并点击进入
3. 在 mcp.json 中添加：

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

请参考其他客户端的相关文档

🛠️ 可用工具

list-devices

列出所有已连接的设备。

list-scripts

列出所有可用的自动化脚本。

run-script

在指定设备上运行脚本。

参数

• ScriptId: 表示要运行的脚本ID的24位十六进制字符串
• Devices: 设备列表，包括设备ID和可选的设备名称
• Vars: （可选）传递给脚本的变量

execute

在指定设备上执行自定义的 JavaScript 代码。

参数

• Code: JavaScript Hamibot 代码
• Devices: 设备列表，包括设备ID和可选的设备名称
• Vars: （可选）传递给代码的变量

📝 示例

• 获取设备列表
• 获取脚本列表
• 在 "设备名" 上运行脚本 "脚本名" 添加引号到设备名称和脚本名称会使它更清晰，例如 在 "初号机" 上运行脚本 "演示脚本"

• 在所有 tag1 标签的设备上运行 "演示脚本"
• 在初号机上运行这个脚本文件

💻 开发

# 构建项目
npm run build

# 启动服务器
npm start

# 开发模式（监视文件变化）
npm run watch