mcpField
🤖
🤖 Hamibot MCP Server

🤖 Hamibot MCP Server

本地服务
hamibot.com其他978 周前更新
代码仓库访问官网

关于 🤖 Hamibot MCP Server

Hamibot MCP Server 连接 Hamibot API，用于管理设备和自动化脚本。客户端可列出设备与脚本、运行脚本，或在指定设备上执行自定义 JavaScript。

主要功能

  1. 01列出已连接设备
  2. 02列出自动化脚本
  3. 03在指定设备运行脚本
  4. 04在设备执行自定义 JavaScript
  5. 05向脚本或代码传递变量

适用场景

  1. 01查看当前连接的设备
  2. 02查找可用自动化脚本
  3. 03在选定设备运行脚本
  4. 04执行设备专用 JavaScript

MCP 相关

它将 Hamibot 设备与脚本管理、脚本运行及 JavaScript 执行功能作为工具提供给 MCP 客户端。

#mcp#hamibot#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "hamibot": {
      "command": "npx",
      "args": [
        "-y",
        "@hmbt/hamibot-mcp-server"
      ],
      "env": {
        "HAMIBOT_PERSONAL_ACCESS_TOKEN": "<HAMIBOT_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}
启动命令npx -y @hmbt/hamibot-mcp-server
需要配置的环境变量
HAMIBOT_PERSONAL_ACCESS_TOKEN密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@hmbt/hamibot-mcp-server

工具

4

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

来自项目 README

🤖 Hamibot MCP Server

Hamibot MCP Server 是一个基于 Model Context Protocol (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: 24 位十六进制字符串，表示要运行的脚本 ID
  • devices: 设备列表，包含设备 ID 和可选的设备名称
  • vars: (可选) 传递给脚本的变量
execute

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

参数：

  • code: JavaScript Hamibot 代码
  • devices: 设备列表，包含设备 ID 和可选的设备名称
  • vars: (可选) 传递给代码的变量

📝 示例

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

运行脚本 运行脚本

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

运行脚本文件

💻 开发

# 构建项目
npm run build

# 启动服务器
npm start

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。