mcpField
B
Buddy phone tools

Buddy phone tools

ローカル
ghorbelhamdi.github.ioその他1392 日前に更新
リポジトリ公式サイト

Buddy phone tools について

Buddy phone tools は Buddy Android アプリ内で動作するローカル MCP サーバーで、画面の読み取り、タップ、入力、アプリ起動などの操作を AI エージェントに提供します。コマンドでのみサーバーを起動できる MCP クライアント向けに stdio ブリッジも備えています。

主な機能

  1. 01画面の読み取りとスクリーンショット
  2. 02タップ、入力、スクロール
  3. 03アプリとバックグラウンドブラウザーの起動
  4. 04通知の確認
  5. 05stdio ブリッジの提供

活用シーン

  1. 01エージェントによるスマートフォン画面の確認
  2. 02タップや文字入力の自動化
  3. 03アプリを開いて操作
  4. 04コマンド起動のみの MCP クライアントから Buddy に接続

MCP 対応

Buddy は Android スマートフォン上で、既定で `http://127.0.0.1:8765/mcp` にローカル MCP サーバーを提供します。stdio ブリッジは MCP クライアントからのリクエストを Buddy に転送します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "ghorbelhamdi-buddy-phone-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "<BUDDY_TOKEN>",
        "BUDDY_URL": "<BUDDY_URL>"
      }
    }
  }
}
起動コマンドnpx -y buddy-phone-bridge
設定が必要な環境変数
BUDDY_TOKENシークレットToken from Buddy's Settings > Phone tools in your own sessions
BUDDY_URLBuddy's address, if not http://127.0.0.1:8765/mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmbuddy-phone-bridge1.1.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Buddy スマートフォンブリッジ（stdio）

Buddy のスマートフォン用ツール（画面の読み取り、タップ、入力、スクロール、アプリの起動、スクリーンショット、通知、バックグラウンドブラウザーなど）は、Android スマートフォン上の Buddy アプリ内にあるローカル MCP サーバーです：http://127.0.0.1:8765/mcp。ほとんどのエージェントは直接接続します。Buddy の 設定 → 自分のセッションでのスマートフォン用ツール には、Claude Code、Codex、OpenCode、Antigravity、Grok 用のコマンドが表示されます。

このブリッジは、コマンドとしてのみサーバーを起動できる MCP クライアント向けです。stdio 経由で MCP を通信し、すべてのリクエストを Buddy に転送します。依存関係はありません（Node 18+）。

BUDDY_TOKEN=<token from Buddy's Settings> node bridge.mjs

MCP クライアントの設定：

{
  "mcpServers": {
    "phone": {
      "command": "node",
      "args": ["/path/to/mcp-bridge/bridge.mjs"],
      "env": { "BUDDY_TOKEN": "<token from Buddy's Settings>" }
    }
  }
}
  • BUDDY_TOKEN：Buddy に表示されるトークン（Bearer の有無は問いません）。
  • BUDDY_URL：Buddy のアドレス。http://127.0.0.1:8765/mcp 以外の場合に指定します。

スマートフォン本体（たとえば Termux）で実行してください。Buddy は 127.0.0.1 でのみ待ち受けます。Buddy に接続できない場合も、ブリッジはツールを一覧表示します（Buddy の一覧をコピーした tools.json を使用）。各呼び出しでは実行できなかった理由が示されます。スマートフォンがない Dockerfile のコンテナでも同様です。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。