🚀 🤖 鹤鼻兽机器人 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