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 桁の 16 進数文字列で、実行するスクリプトの ID を表します。
• devices: デバイス ID とオプションのデバイス名を含むデバイスリスト
• vars: (オプション) スクリプトに渡す変数

execute

指定されたデバイス上でカスタム JavaScript コードを実行します。

パラメータ：

• code: 鶴鼻獸ロボットの JavaScript コード
• devices: デバイス ID とオプションのデバイス名を含むデバイスリスト
• vars: (オプション) コードに渡す変数

📝 使用例

• デバイスリストを取得
• スクリプトリストを取得
• 「デバイス名」上で「スクリプト名」を実行、デバイス名とスクリプト名を引用符で囲むと、より明確になります。例えば 「初号機」上で「デモスクリプト」を実行

• すべての tag1 タグ付きデバイス上で「デモスクリプト」を実行
• 初号機上でこのスクリプトファイルを実行

💻 開発

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

# 開発モード（ファイルの変更を監視）
npm run watch