hamibot-mcp-server

View on GitHub

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

5 stars JavaScriptDeveloper Kits Updated Aug 17, 2025

hamibotmcpmcp-server

Documentation

🤖 Hamibot MCP Server

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

✨ 功能特性

设备管理：列出所有连接的设备
脚本管理：查看和运行自动化脚本
代码执行：在指定设备上执行自定义 JavaScript 代码
支持变量传递：可以向脚本传递自定义参数

⚙️ 配置

获取访问令牌

1. 访问

2. 点击生成

在 Trae 中使用

详细步骤参考 Trae 文档：

1. 按键 `F1`

2. 输入 `open mcp config json`，点击进去

3. 在 `mcp.json` 中添加：

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 标签的设备上运行 "演示脚本"`
`在初号机上运行这个脚本文件`

💻 开发

bash

# 构建项目
npm run build

# 启动服务器
npm start

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

Frequently asked questions

What is hamibot-mcp-server?

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

How do I install hamibot-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is hamibot-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/hamibot/hamibot-mcp-server and has 5 stars.

Related MCP tools

firecrawl-mcp-server

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.

4,847 JavaScript

batch-processingclaudecontent-extraction+11

mcp-shrimp-task-manager

Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency.

1,850 JavaScript

agentaicodeagent+12

mcp-jetbrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

965 JavaScript

ideintellijjetbrains+3

mcp-jetbrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

926 JavaScript

ideintellijjetbrains+3

linear-mcp-server

A server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.

331 JavaScript

anthropiclinearmcp+2

mcp

AWS MCP Servers — helping you get the most out of AWS, wherever you use MCP. Python-based implementation. Trusted by 6900+ developers.

6,922 Python

awsmcpmcp-client+6

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP