CodeDroid

本地服务

get.codedroid.com开发工具1今天更新

代码仓库访问官网

关于 CodeDroid

CodeDroid 是供编码 Agent 和其他 MCP 客户端操作已配对 Android 手机的 MCP 服务。它提供屏幕查看、输入、应用控制和设备测试工具，手机与电脑可处于不同网络。

主要功能

01读取屏幕并截取截图
02点击、输入、滑动和打开应用
03委托多步骤手机任务
04从电脑安装 APK
05运行 adb 命令并读取日志

适用场景

01开发时检查应用界面
02在手机上测试登录流程
03安装构建并检查崩溃
04运行设备测试并查看日志

MCP 相关

提供 MCP 工具，在客户端与已配对的 Android 手机之间转发操作和屏幕数据。本地服务经由 CodeDroid 服务器连接；可选的 adb 工具在电脑上运行命令。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codedroid-team-codedroid": {
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ],
      "env": {
        "CODEDROID_MCP_ADB": "<CODEDROID_MCP_ADB>",
        "CODEDROID_SERIAL": "<CODEDROID_SERIAL>",
        "CODEDROID_MCP_CLIENT": "<CODEDROID_MCP_CLIENT>"
      }
    }
  }
}

启动命令npx -y @codedroid/mcp

需要配置的环境变量

CODEDROID_MCP_ADBSet to 0 to turn off the adb tool, which runs adb commands on this computer.

CODEDROID_SERIALadb serial of the phone to use when several devices are connected.

CODEDROID_MCP_CLIENTClient name shown on the phone while the agent uses it.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codedroid/mcp0.1.4stdio

工具

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

此工具无需参数。

详细介绍

CodeDroid MCP

让 Claude Code、Codex、Gemini CLI 或任何 MCP 客户端使用你的 Android 手机。通过 CodeDroid 读取屏幕、与应用交互、截屏，并测试你构建的应用。手机和电脑可以连接到不同的网络。

开始使用

你需要 Node.js 20+ 和 Android 手机上安装的 CodeDroid，并登录账号且启用无障碍服务。两台设备都需要接入互联网。

1. 为你的编码客户端安装

一次安装到所有客户端——在终端中运行：

npx -y @codedroid/mcp setup

它会查找 Claude Code、Codex、Gemini CLI、Cursor、VS Code、Claude Desktop 和 Windsurf，并在你确认后将 CodeDroid 添加到每个客户端。更新后再次运行；已完成设置的客户端会自动跳过。或者为单个客户端安装：

Claude Code——在 Claude Code 中运行：

/plugin marketplace add codedroid-team/codedroid-mcp
/plugin install codedroid@codedroid

Codex——在终端中运行：

codex plugin marketplace add codedroid-team/codedroid-mcp
codex plugin add codedroid@codedroid

Gemini CLI——在终端中运行：

gemini extensions install https://github.com/codedroid-team/codedroid-mcp

每次安装都会包含 MCP 服务，以及用于控制手机和测试 Android 应用的技能。安装后请重启编码客户端。

使用其他客户端？请参阅手动配置 MCP。

2. 配对手机

在手机上打开 CodeDroid → Settings → Computers → Pair a computer。
在电脑的终端中运行此处显示的命令。例如：
```
npx -y @codedroid/mcp pair ABCD-EFGH
```
出现提示时，在手机上点按 Allow。

请完全按照显示的命令运行。配对码会在 10 分钟后过期，且只能使用一次。

3. 向 Agent 提出要求

读取我手机上的屏幕，并描述当前打开的内容。

然后试试：

“打开 Android 设置并查看 Android 版本。”
“打开我的应用，进入登录页面，然后截屏。”
“安装这个 APK，启动它，并检查是否崩溃。”*

*install_apk 可通过 CodeDroid 的连接使用，只需启用一项设置。使用 adb 读取日志也需要 Android platform-tools，以及 USB 或无线调试连接。请参阅 adb 设置。

包含的功能

MCP 工具：读取屏幕、截屏、点按、输入、滑动、打开应用，并将多步骤任务交给 CodeDroid 的 Agent；支持一部手机或多部手机。请参阅工具列表。
技能：codedroid-phone 会引导 Agent 一次执行一个经过检查的步骤来操控手机；test-on-device 会引导它完成 Android 应用变更的构建、安装和验证。 create-cujs 会将应用的关键用户旅程写入其代码库中的 markdown 文件（cujs/），create-tests 会为这些旅程添加测试用例，而 test-on-device 会在手机上运行这些旅程。
install_apk：从电脑安装构建产物，无需数据线或共享网络。
adb 工具：在电脑上运行 adb 命令，以读取日志和运行测试。你可以关闭它。

隐私与安全

该插件运行 npx -y @codedroid/mcp@<version>，从 npm 下载这个确切版本，并启动本地 MCP 服务。插件发送的所有内容都会通过 TLS 传输到 CodeDroid 服务 orchestrator.codedroid.com，除非手机上显示的配对命令指定了其他服务：

配对会发送一次性代码、你的电脑名称及其操作系统（例如 darwin），以便手机显示已连接的电脑。
工具调用会在你的 Agent 与手机之间转发：屏幕内容、屏幕截图、你要求手机输入的文本、剪贴板读取和写入操作，以及任务进度。每次调用还会注明发起调用的 MCP 客户端及其版本。手机会在电脑首次连接时询问你是否允许，并显示电脑正在使用的状态，你也可以停止或撤销访问权限。

本地服务仅监听 127.0.0.1，并要求使用每位用户各自的令牌。配对凭据、令牌和日志都保存在你电脑的 ~/.codedroid 中。adb 工具仅在你的电脑上运行，其 push 和 pull 操作仅在项目目录和临时目录内进行。详情请参阅架构。

插件本身不会收集分析数据。CodeDroid 应用和服务会在你的 CodeDroid 账户下保留使用记录，包括配对和连接、电脑是否获准，以及每次手机工具调用的名称、是否成功及其错误代码、耗时、涉及的 MCP 客户端、会话和版本、电脑的操作系统及其随机 ID，以及 run_task 的任务 ID。使用记录绝不包含工具参数、屏幕内容或你输入的文本。

需要帮助？

检查你的连接：

npx -y @codedroid/mcp status

在 CodeDroid → Settings → Computers 中管理或撤销电脑访问权限。

请参阅参考指南，了解工具、手动设置、配置、故障排除和开发相关信息。

许可证

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。