AI 智能体与 MCP

通过 droidline mcp，让 Claude、Cursor、VS Code 或任何 MCP 客户端能够查看并操作 Android 手机，包含每种客户端的设置方法和获得好结果的技巧。

MCP（Model Context Protocol）是 AI 助手使用外部工具的标准方式。droidline mcp 是一个 MCP 服务器：你的助手连接到它之后，就能查看手机屏幕，并在上面点击、输入和滚动，所用的命令与你在脚本中使用的相同。

工作原理

每条 Droidline 命令都对应一个同名工具。名称中的点改为下划线：chrome.go 变成 chrome_go。
dump 返回去掉了空字段的精简界面树，因此模型消耗的 token 更少。
screenshot 返回一张模型能看到的图片。
服务器会告诉智能体该怎么做：用 dump 查看界面，按 text、id 或 desc 操作元素，只在没有元素的界面上使用坐标。
如果 droidline serve 没有运行，droidline mcp 会在自己的进程中启动一个服务器。你仍然需要用 droidline pair 配对一次手机。

设置客户端

选择你所用助手的标签页。无论哪种情况，命令都是 droidline mcp；如果 droidline 不在 PATH 中，请改用程序的完整路径，例如 C:\\Tools\\droidline\\droidline.exe（在 JSON 中反斜杠要写两次）。

claude mcp add droidline -- droidline mcp

然后启动 claude，让它查看你的手机。claude mcp list 会显示服务器是否已连接。

依次打开 Settings、Developer、Edit Config，或者直接编辑配置文件：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "droidline": { "command": "droidline", "args": ["mcp"] }
  }
}

重启 Claude Desktop。新对话的工具菜单中会出现 Droidline 的工具。

把下面的内容加入 ~/.cursor/mcp.json，对所有项目生效；或者加入某个项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "droidline": { "command": "droidline", "args": ["mcp"] }
  }
}

打开 Cursor 的设置，进入 MCP，确认 droidline 已列出并已启用。

把下面的内容加入工作区中的 .vscode/mcp.json：

{
  "servers": {
    "droidline": { "type": "stdio", "command": "droidline", "args": ["mcp"] }
  }
}

点击配置上方出现的 CodeLens 启动服务器，然后在 Copilot 的智能体模式中使用这些工具。

任何能通过标准输入和标准输出启动服务器的 MCP 客户端都可以使用。把它配置为运行：

droidline mcp

不需要设置任何环境变量。如果存在 DROIDLINE_DEVICE、DROIDLINE_TOKEN 等设置，会读取它们。

选择手机

只有一部手机在线时，智能体就使用它。有多部手机时，智能体会调用 devices，并在每次调用工具时传入 device。要把智能体固定到一部手机上，加上 --device：

{
  "mcpServers": {
    "droidline": { "command": "droidline", "args": ["mcp", "--device", "shelf-01"] }
  }
}

添加两个名称和设备都不同的条目，一个助手就能按名称使用两部手机。

怎样提问效果好

目标明确并且有办法验证结果时，智能体表现最好。下面是一些效果不错的提示：

“打开我手机上的设置，告诉我它连接的是哪个 Wi-Fi 网络。”
“在演示应用中以 knife 身份登录，然后告诉我主界面上的余额。”
“截一张图，找到关闭这个弹窗的按钮，然后点击它。”
“用 droidline 包写一个 Python 脚本，完成你刚才做的事。”

最后一条是个好习惯：先让智能体探索一次新应用，再把它做过的操作变成一个不需要它也能运行的脚本。

谨慎选择要连接的手机

连接到 droidline mcp 的智能体能做你在手机上能做的任何事，包括发送消息和更改设置。试用期间，请使用测试手机或没有登录个人账户的手机，并在客户端中保持逐个工具确认的功能开启，用于 clear_data、input 和 notification_reply 等会修改数据的命令。