Buddy phone tools

Name: Buddy phone tools
Author: ghorbelhamdi

本地服务

ghorbelhamdi.github.io其他1411 天前更新

代码仓库访问官网

关于 Buddy phone tools

Buddy phone tools 是 Buddy Android 应用内的本地 MCP 服务，为 AI Agent 提供读取屏幕、点击、输入和打开应用等手机操作工具。附带的 stdio 桥接程序可供只能通过命令启动服务的 MCP 客户端使用。

主要功能

01读取手机屏幕并截图
02点击、输入和滚动操作
03打开应用与后台浏览器
04查看通知
05提供 stdio 桥接程序

适用场景

01让 Agent 查看手机界面
02自动执行点击和输入
03打开应用并进行操作
04从仅支持命令启动的客户端连接 Buddy

MCP 相关

Buddy 在 Android 手机上提供本地 MCP 服务，地址默认为 `http://127.0.0.1:8765/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.0stdio

工具

收录的工具列表 · 更新于 1 天前

此工具无需参数。

详细介绍

Buddy 手机桥接（stdio）

Buddy 的手机工具（读取屏幕、点击、输入、滚动、打开应用、截图、通知、后台浏览器等）是 Android 手机上的 Buddy 应用内置的本地 MCP 服务：http://127.0.0.1:8765/mcp。大多数 Agent 会直接连接到该服务；在 Buddy 的 Settings → Phone tools in your own sessions 中，可以获取 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>" }
    }
  }
}