Hamibot MCP Server

🚀 鶴鼻獸機器人 MCP 服務器

鶴鼻獸機器人 MCP 服務器是基於模型上下文協議 (MCP) 的服務器實現，可與鶴鼻獸機器人 API 交互。它提供了一系列工具，能對鶴鼻獸機器人設備及腳本進行管理與控制。

✨ 主要特性

• 設備管理：可列出所有已連接的設備。
• 腳本管理：能查看和運行自動化腳本。
• 代碼執行：可在指定設備上執行自定義 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

在指定設備上運行腳本。 參數：

• scriptId：24 位十六進制字符串，表示要運行的腳本 ID。
• devices：設備列表，包含設備 ID 和可選的設備名稱。
• vars：(可選) 傳遞給腳本的變量。

execute

在指定設備上執行自定義 JavaScript 代碼。 參數：

• code：JavaScript 鶴鼻獸機器人代碼。
• devices：設備列表，包含設備 ID 和可選的設備名稱。
• vars：(可選) 傳遞給代碼的變量。

💻 使用示例

基礎用法

• 獲取設備列表
• 獲取腳本列表
• 在 "設備名" 上運行腳本 "腳本名"，設備名和腳本名加引號會更明確，例如 在 "初號機" 上運行腳本 "演示腳本"。
• 在所有 tag1 標籤的設備上運行 "演示腳本"
• 在初號機上運行這個腳本文件

💻 開發

# 構建項目
npm run build

# 啟動服務器
npm start

# 開發模式（監視文件變化）
npm run watch