日本語

MCP-ADB

一个模型上下文协议 (MCP) 服务器，提供与 Android 调试桥 (ADB) 的集成，以便 AI 助手与 Android 设备进行交互。

特性

• 屏幕截图捕获: 捕获连接的 Android 设备的屏幕截图，并自动调整大小
• Base64 图像数据: 直接接收作为 Base64 编码字符串的屏幕截图数据
• 按键事件控制: 向 Android 设备发送按键事件（导航、返回、主页）
• 多设备支持: 在连接多个设备时，可以指定目标设备
• 设备列表: 将所有连接的 Android 设备列为资源
• 资源访问: 通过资源 URI 访问屏幕截图和设备信息

前提条件

• Node.js (推荐 v16 或更高版本)
• Android 调试桥 (ADB) 已安装并在 PATH 中可用，或者通过 ADB_PATH 环境变量配置
• 已连接的 Android 设备，并启用了 USB 调试

安装

# 克隆仓库
git clone https://github.com/isseikz/mcp-adb.git
cd mcp-adb

# 安装依赖
npm install

# 构建项目
npm run build

使用

与 Claude Desktop 一起使用

要将此 MCP 服务器与 Claude Desktop 一起使用，请将 mcp-adb 添加到 claude_desktop_config.json 中。该文件可以在 Claude Desktop 安装目录或 Claude - 设置 - 开发者 - 编辑配置中找到。

以下是如何配置 claude_desktop_config.json 文件的示例：

{
  "mcpServers": {
    "mcp-adb": {
      "command": "node",
      "args": ["/path/to/mcp-adb/build/index.js"],
      "env": {
        "ADB_PATH": "/path/to/adb"
      }
    }
  }
}

```json
{
  "mcpServers": {
    "mcp-adb": {
      "command": "node",
      "args": ["/path/to/mcp-adb/build/index.js"],
      "env": {
        "ADB_PATH": "/path/to/adb"
      }
    }
  }
}

可用工具

屏幕截图工具

从连接的 Android 设备捕获屏幕截图，并自动将其大小调整为 640px 宽度。

参数：

• deviceId (可选): 在连接多个设备时，指定目标设备

响应：

• 直接在响应中返回 Base64 编码的图像数据（PNG 格式）

示例：

{
  "name": "screenshot",
  "arguments": {
    "deviceId": "emulator-5554"
  }
}

按键工具

向连接的 Android 设备发送按键事件。

参数：

• keycode: 要发送的 Android 键码（参见下面的列表）
• deviceId (可选): 在连接多个设备时，指定目标设备

可用键码：

• KEYCODE_DPAD_CENTER - 中心/确定按钮
• KEYCODE_DPAD_DOWN - 向下导航
• KEYCODE_DPAD_UP - 向上导航
• KEYCODE_DPAD_LEFT - 向左导航
• KEYCODE_DPAD_RIGHT - 向右导航
• KEYCODE_DPAD_UP_LEFT - 左上对角线
• KEYCODE_DPAD_UP_RIGHT - 右上对角线
• KEYCODE_DPAD_DOWN_LEFT - 左下对角线
• KEYCODE_DPAD_DOWN_RIGHT - 右下对角线
• KEYCODE_BACK - 返回按钮
• KEYCODE_HOME - 主页按钮

示例：

{
  "name": "pressKey",
  "arguments": {
    "keycode": "KEYCODE_DPAD_DOWN",
    "deviceId": "emulator-5554"
  }
}

资源

连接的设备

列出所有连接的 Android 设备：

adb://devices

响应：

• 连接的设备 ID 列表

屏幕截图

通过文件名访问特定的屏幕截图：

adb://screenshots/{filename}

例如：

adb://screenshots/screenshot-2025-04-10T16-30-48-931Z.png

开发

项目结构

mcp-adb/
├── src/
│   └── index.ts    # 主要服务器实现
├── build/          # 编译后的 JavaScript 文件
├── temp/           # 屏幕截图的临时目录
├── package.json    # 项目依赖和脚本
└── tsconfig.json   # TypeScript 配置

构建

npm run build

这会将 TypeScript 代码编译为 build 目录中的 JavaScript。

要求

本项目使用以下依赖项：

• @modelcontextprotocol/sdk: MCP 服务器实现
• fs-extra: 增强的文件系统方法
• sips: 用于图像大小调整（内置于 macOS 中），以减少上下文消耗

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。