金大哥 - hamibot-mcp-server MCP 详情

article

README

🚀 🤖 鹤鼻兽机器人 MCP 服务器

鹤鼻兽机器人 MCP 服务器是基于模型上下文协议 (MCP) 的服务器实现，可与鹤鼻兽机器人 API 交互。它提供了一系列工具，用于管理和控制鹤鼻兽机器人设备及脚本，极大提升了使用的便捷性和效率。

🚀 快速开始

鹤鼻兽机器人 MCP 服务器能让你轻松管理和控制鹤鼻兽机器人设备及脚本。下面为你介绍使用前的准备工作。

✨ 主要特性

🔧 设备管理：可列出所有连接的设备，方便你掌握设备状态。
📜 脚本管理：能查看和运行自动化脚本，提高工作效率。
💻 代码执行：支持在指定设备上执行自定义 JavaScript 代码，满足个性化需求。
📦 支持变量传递：可以向脚本传递自定义参数，增强脚本的灵活性。

⚙️ 配置

获取访问令牌

访问 https://hamibot.com/account/tokens。
点击“生成”按钮获取访问令牌。

在 Trae 中使用

详细步骤可参考 Trae 文档：https://docs.trae.ai/ide/model-context-protocol?_lang=zh。

按下按键 F1。
输入 打开 MCP 配置 JSON，然后点击进入。
在 mcp.json 中添加以下内容：

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

⚠️ 重要提示

其他客户端请参考相应的文档进行配置。

🛠️ 可用工具

list-devices

列出所有已连接的设备，方便你了解设备连接情况。

list-scripts

列出所有可用的自动化脚本，让你快速找到所需脚本。

run-script

在指定设备上运行脚本。 参数说明： | 属性 | 详情 | |------|------| | scriptId | 24 位十六进制字符串，表示要运行的脚本 ID | | devices | 设备列表，包含设备 ID 和可选的设备名称 | | vars | (可选) 传递给脚本的变量 |

execute

在指定设备上执行自定义 JavaScript 代码。 参数说明： | 属性 | 详情 | |------|------| | code | JavaScript 鹤鼻兽机器人代码 | | devices | 设备列表，包含设备 ID 和可选的设备名称 | | vars | (可选) 传递给代码的变量 |

💻 使用示例

基础用法

以下是一些常见的使用示例：

获取设备列表
获取脚本列表
在 "设备名" 上运行脚本 "脚本名"，设备名和脚本名加引号会更明确，例如 在 "初号机" 上运行脚本 "演示脚本"

运行脚本

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

运行脚本文件

📚 详细文档

开发

# 构建项目
npm run build

# 启动服务器
npm start

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

hamibot-mcp-server