# @codedroid/mcp 中文文档

规范地址：https://npmcn.com/package/%40codedroid/mcp/

版本：0\.1\.11
npm 元数据更新时间：2026-11-09T22:24:30.792Z
中文译文更新时间：2026-11-10T07:54:49.621Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40codedroid/mcp
原文对照：https://npmcn.com/package/%40codedroid/mcp/?lang=original
项目主页：https://get.codedroid.com/
源码仓库：https://github.com/codedroid-team/codedroid-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：238 kB，37 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-10-21T17:40:31.285Z
- 最新版本发布：2026-11-09T22:24:30.554Z
- 近 30 天下载量：2229（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

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

## 安装

```sh
npm install @codedroid/mcp
```

也可以使用：`pnpm add @codedroid/mcp`、`yarn add @codedroid/mcp`、`bun add @codedroid/mcp`

## README

# 代码Droid MCP

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

## 开始吧

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

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

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

```bash
npx -y @codedroid/mcp setup
```

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

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

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

**代码** - 在你的终端运行:

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

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

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

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

利用另一个客户端? 见 [手动 MCP 设置](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#mcp-configuration)。 。 。 .

### 电话对齐

1.  打开 **代码Droid 设置 计算机 配对计算机** 在你的电话.
    
2.  运行您计算机终端显示的命令 。 例如:
    
    ```bash
    npx -y @codedroid/mcp pair ABCD-EFGH
    ```
    
3.  磁带 **允许** 在你的电话,当提醒.
    

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

### 3\. 问你的经纪人

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

那就试试:

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

\* 联合国`install_apk` 运行于 CodeDroid 的连接 [一个设置允许](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#installing-builds)读取日志 `adb` 还要求 Android平台-工具以及USB或无线调试连接. 见 [设置](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#adb-setup)。 。 。 .

## 包括什么

-   **MCP工具** 读取屏幕、截图、相机、类型、刷相、打开应用程序和手 代码Droid的代理是一个多步任务,在一个电话上或 [多个](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#several-phones)。 。 。 . 见 [工具列表](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#tools)。 。 。 .
-   **技能**数字 : `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命令, 读取日志和运行测试。 你们可以 [关掉](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#adb-setup)。 。 。 .

## 隐私和安全

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

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

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

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

## 需要帮忙吗?

检查您的连接 :

```bash
npx -y @codedroid/mcp status
```

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

见 [参考指南](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md) 用于工具,手动设置,配置, [排除出问题](https://npmcn.com/package/%40codedroid/mcp/docs/reference.md#troubleshooting),与发展.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40codedroid/mcp/LICENSE) 2026 密码机器人

## 常见问题

### @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 和提交记录判断。