landicefu

@landicefu/android-adb-mcp-server

1 Stars 433 次浏览 landicefu 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "android-adb": {
      "alwaysAllow": [],
      "args": [
        "-y",
        "@landicefu/android-adb-mcp-server"
      ],
      "command": "npx",
      "disabled": false,
      "env": {}
    }
  }
}

服务介绍

Android ADB MCP 服务器

一个模型上下文协议（MCP）服务器，它通过Android调试桥（ADB）使AI助手能够与Android设备进行交互。该服务器在AI能力和Android设备管理之间架起了一座桥梁，允许无缝自动化Android开发和测试操作。

⚙️ 快速设置

将服务器添加到您的MCP配置文件中：

json
{
"mcpServers": {
"android-adb": {
"command": "npx",
"args": ["-y", "@landicefu/android-adb-mcp-server"],
"env": {},
"disabled": false,
"alwaysAllow": []
}
}
}

配置位置

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Cline/Roo Code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json (macOS)
对于Windows/Linux，请检查相应的应用程序支持目录

配置完成后，重启您的AI助手以加载新的服务器配置。

📋 先决条件

ADB (Android Debug Bridge) 必须已安装并可在系统PATH中找到
- 在Windows、macOS或Linux上安装ADB
- 通过在终端运行adb version验证安装
对于剪贴板功能：
- macOS: osascript（内置）
- Windows: PowerShell（内置）
- Linux: xclip（通过apt-get install xclip或等效命令安装）
Node.js 16.x 或更高版本

🚀 功能

连接并管理多个Android设备
在Android设备上执行shell命令
安装和卸载应用程序
在本地系统和Android设备之间推送和拉取文件
在Android设备上启动应用程序
截图并保存到本地或复制到剪贴板
当连接了多个设备时智能选择设备

🛠️ 可用工具

工具	描述	必需参数	可选参数
`adb_devices`	列出已连接的设备	无	无
`adb_shell`	执行shell命令	`command`	`device_id`
`adb_install`	安装APK文件	`path`	`device_id`
`adb_uninstall`	卸载应用程序	`package_name`	`device_id`
`adb_list_packages`	列出已安装的包	无	`device_id`, `filter`
`adb_pull`	从设备拉取文件	`remote_path`, `local_path`	`device_id`
`adb_push`	将文件推送到设备	`local_path`, `remote_path`	`device_id`
`launch_app`	启动应用程序	`package_name`	`device_id`
`take_screenshot_and_save`	截图并保存	`output_path`	`device_id`, `format`
`take_screenshot_and_copy_to_clipboard`	截图至剪贴板	无	`device_id`, `format`

设备管理

服务器智能处理设备选择：

如果只连接了一个设备，则会自动使用该设备
如果连接了多个设备，则必须指定device_id参数
如果没有设备连接，则会返回错误

截图路径解析

当指定用于保存截图的output_path时，路径按如下方式解析：

绝对路径直接使用
以~开头的路径会被扩展为用户的家目录
相对路径相对于用户的家目录解析

这确保了截图被保存到MCP服务器具有写权限的位置。

🔍 故障排除

常见问题

"ADB不可用"错误
- 确保ADB已安装并在您的系统PATH中
- 通过在终端运行adb version来验证
"没有Android设备连接"错误
- 使用adb devices检查您的设备是否正确连接
- 确保设备上的USB调试已启用
- 尝试通过adb kill-server后跟adb start-server重启ADB
"连接了多个设备"错误- 指定工具调用中的 device_id 参数

使用 adb_devices 工具获取可用设备列表

截图到剪贴板功能不工作
- 确保已安装所需的特定平台工具

🔧 替代安装方法

选项1：从npm安装

bash

全局安装

npm install -g @landicefu/android-adb-mcp-server

或者在您的项目中本地安装

npm install @landicefu/android-adb-mcp-server

选项2：从源代码手动安装

克隆仓库：
bash
git clone https://github.com/landicefu/android-adb-mcp-server.git
cd android-adb-mcp-server
安装依赖并构建：
bash
npm install
npm run build
使用直接路径配置：
json
{
"mcpServers": {
"android-adb": {
"command": "node",
"args": ["/path/to/android-adb-mcp-server/build/index.js"],
"env": {},
"disabled": false,
"alwaysAllow": []
}
}
}

📄 许可证

本项目采用ISC许可证发布 - 详情请参阅LICENSE文件。

🤝 贡献

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

叉分仓库
创建你的特性分支 (git checkout -b feature/amazing-feature)
提交你的更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开一个Pull Request

查看源码项目主页