Hamibot MCP Server

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

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

🚀 快速开始

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

✨ 主要特性

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

⚙️ 配置

获取访问令牌

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

在 Trae 中使用

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

1. 按下按键 F1。
2. 输入 打开 MCP 配置 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

在指定设备上运行脚本。 参数说明：

execute

在指定设备上执行自定义 JavaScript 代码。 参数说明：

💻 使用示例

基础用法

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

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

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

📚 详细文档

开发

# 构建项目
npm run build

# 启动服务器
npm start

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