🤖 Hamibot MCP Server

用于与 Hamibot API 进行交互。它提供了一系列工具来管理和控制 Hamibot 设备及脚本

Local serverstdio

What is the 🤖 Hamibot MCP server?

用于与 Hamibot API 进行交互。它提供了一系列工具来管理和控制 Hamibot 设备及脚本. That is what the 🤖 hamibot mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

Hamibot MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,用于与 Hamibot API 进行交互。它提供了一系列工具来管理和控制 Hamibot 设备及脚本。

The tools it exposes

The server publishes 5 tools. What each one is for:

  • scriptId — 24 位十六进制字符串,表示要运行的脚本 ID
  • devices — 设备列表,包含设备 ID 和可选的设备名称
  • vars — (可选) 传递给脚本的变量
  • code — JavaScript Hamibot 代码
  • execute — The execute tool exposed by this server

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

What it needs from you

Configuration is passed through the environment: HAMIBOT_PERSONAL_ACCESS_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. 🤖 Hamibot's toolset — scriptId, devices, vars and 2 more — is a fair guide to whether it matches your workflow. It is maintained by hamibot; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
scriptId24 位十六进制字符串,表示要运行的脚本 ID
devices设备列表,包含设备 ID 和可选的设备名称
vars(可选) 传递给脚本的变量
codeJavaScript Hamibot 代码
executeThe execute tool exposed by this server.

How to install the 🤖 Hamibot MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
HAMIBOT_PERSONAL_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use 🤖 Hamibot to scriptId.
  • Use 🤖 Hamibot to devices.
  • Use 🤖 Hamibot to vars.

Frequently asked questions

Visit [https://hamibot.com/account/tokens](https://hamibot.com/account/tokens) and generate a new token.