@codedroid/mcp

中文文档
0.1.11发布于 2026/11/10MITES Module近 30 天下载 2229

MCP服务器,用于通过来自克洛德代码,Codex,双子座CLI等MCP客户端的CodeDroid控制Android设备.

中文使用文档
文档目录8 节
  1. 开始吧
  2. 1. 为您的编码客户端安装
  3. 电话对齐
  4. 3. 问你的经纪人
  5. 包括什么
  6. 隐私和安全
  7. 需要帮忙吗?
  8. 许可证

代码Droid MCP

让Claude Code, Codex,双子座CLI, 或任何MCP客户端使用你的Android手机. 阅读屏幕,与应用程序互动,取取截图,测试所构建的东西 结束 代码Droid您的手机和电脑可以在不同网络上.

开始吧

你会需要的 节点.js 20+ 财务报告和审定财务报表 你Android手机上的代码Droid,与 启用了无障碍服务。 这两个设备都需要互联网接入.

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

每个客户一次 - 在你的终端运行:

npx -y @codedroid/mcp setup

它发现了克洛德代码, Codex,双子座CLI, Cursor, VS代码,克洛德桌面,和Windsurf, 并添加了 代码Droid在确认后发给每个人 更新后再次运行; 它跳过客户端 已经设置。 或者为一个客户端安装 :

克劳德代码 在克洛德代码内运行:

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

代码 - 在你的终端运行:

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

双子座CLI - 在你的终端运行:

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

每个安装包括MCP服务器和电话控制和Android应用测试的技能. 安装后重新启动您的编码客户端 .

利用另一个客户端? 见 手动 MCP 设置。 。 。 .

电话对齐

  1. 打开 代码Droid 设置 计算机 配对计算机 在你的电话.

  2. 运行您计算机终端显示的命令 。 例如:

    npx -y @codedroid/mcp pair ABCD-EFGH
    
  3. 磁带 允许 在你的电话,当提醒.

使用所显示的命令 。 配对代码在10分钟后过期,工作一次.

3. 问你的经纪人

阅读我手机上的屏幕 并描述什么是开放的.

那就试试:

  • “打开Android设置并检查Android版本。”
  • “打开我的应用程序
  • “安装这个APK,发射,并检查坠机情况。”

* 联合国install_apk 运行于 CodeDroid 的连接 一个设置允许读取日志 adb 还要求 Android平台-工具以及USB或无线调试连接. 见 设置。 。 。 .

包括什么

  • MCP工具 读取屏幕、截图、相机、类型、刷相、打开应用程序和手 代码Droid的代理是一个多步任务,在一个电话上或 多个。 。 。 . 见 工具列表。 。 。 .
  • 技能数字 : codedroid-phone 教经纪人一个步骤地开车, 财务报告和审定财务报表 test-on-device 通过建造、安装和验证Android应用软件的更改. app-e2e 测试 App 端以结束: 它探索 App , 写一个测试 PRD, 关键用户 旅行和测试病例进入其回收(e2e/),停止对每个案件的审查,运行案件 写一个每起案件都有截图的报告 每一步都是本领 (单位:千美元)app-e2e-explore, (中文(简体) ), -prd, (中文(简体) ), -cujs, (中文(简体) ), -testcases, (中文(简体) ), -run) (中文(简体) ). 礛 app-e2e-rerun 运行一些 (通过编号、旅行或优先级、最后的失败、 变化的触觉、片段) 检查, app-e2e-bug 把虫子变成一个复制它的东西 app-e2e-maintain 保留 随着应用程序的改变,当前的案例.
  • install_apk 从计算机中安装一个构件,没有电缆或共享网络.
  • 一个 adb 工具 在你的电脑上运行adb命令, 读取日志和运行测试。 你们可以 关掉。 。 。 .

隐私和安全

插件运行 npx -y @codedroid/mcp@<version>,从 npm 下载此精确发布 并启动本地 MCP 服务器。 它发送到代码Droid服务器的所有信息, orchestrator.codedroid.com 除非在您的手机名称上显示配对命令 :

  • 配对 发送一次性代码、您的计算机名称及其操作系统( 例如) darwin, (中文(简体) ), 这样电话就可以显示哪台计算机是相连的.
  • 工具调用 在您的代理服务器和电话之间转发:屏幕内容、截图、文本 您请它输入、剪贴板读取和写入,并任务进度。 每个调用也命名 MCP 客户端提供了它及其版本。 电话叫你 允许 第一次用电脑, 显示何时使用,并可以停止或撤销.

本地服务器监听 127.0.0.1 只需要一个每个用户的代号 配对证书, 标记和日志 ~/.codedroid 在你的电脑上。 这个 adb 工具仅运行于您的 计算机及其 push 财务报告和审定财务报表 pull 保留在您的工程和临时目录中。 见 建筑 详细情况.

插件本身不收集分析数据 。 CodeDroid应用软件和服务器将使用记录保存在 您的代码Droid账户: 配对和连接, 是否允许计算机, 以及每个电话 工具调用它的名称, 它是否有效, 及其错误代码, 它花了多长时间, MCP客户端, 涉及的会话和版本,您的计算机的OS和一个随机的代号,以及任务代号 a run_task。使用记录中从未包括工具参数、屏幕内容或您输入的文本.

需要帮忙吗?

检查您的连接 :

npx -y @codedroid/mcp status

管理或取消计算机访问 代码Droid → 设置 → 计算机。 。 。 .

见 参考指南 用于工具,手动设置,配置, 排除出问题,与发展.

许可证

麻省理工学院 2026 密码机器人

版本与发布记录

@codedroid/mcp 共发布 12 个版本,首次发布于 2026/10/22;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.1.11latest2026/11/10今天
0.1.92026/11/073 天前
0.1.82026/11/073 天前
0.1.72026/11/073 天前
0.1.62026/11/073 天前
0.1.52026/11/064 天前

关于 @codedroid/mcp 的常见问题

@codedroid/mcp 是什么?

MCP服务器,用于通过来自克洛德代码,Codex,双子座CLI等MCP客户端的CodeDroid控制Android设备.

如何安装 @codedroid/mcp?

在项目目录运行 npm install @codedroid/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 codedroid-mcp,可以用 npx codedroid-mcp 直接运行。

@codedroid/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/codedroid__mcp 是否存在。

@codedroid/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@codedroid/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@codedroid/mcp 可以商用吗?

@codedroid/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@codedroid/mcp 的下载量有多少?

根据 npm 官方下载统计,@codedroid/mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,229 次,日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@codedroid/mcp 还在维护吗?

最新版本 0.1.11 发布于 2026/11/10(今天);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/10/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。