landicefu

modelscope·@landicefu/android-adb-mcp-server

os-automation0下载LocalModelScope

简介

暂无描述。

MCP Server 详情

来自 ModelScope 索引

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

简介