🚀 ADB MCP 服务器
这是一个用于 Android 调试桥接 (ADB) 的 MCP 服务器，借助它，Claude 能够与 Android 设备进行交互。
📚 技术文章
✨ 主要特性
工具列表
-
get-devices- 功能：列出已连接的 Android 设备
- 参数：无
- 示例输出：
List of devices attached 0a00000000000000 设备名称 model number -
install-apk- 功能：在设备上安装 APK 文件
- 参数：
- 示例：
install-apk /path/to/app.apk -
uninstall-apk- 功能：从设备上卸载应用程序
- 参数：
- 示例：
uninstall-apk com.example.app -
start-activity- 功能：启动指定的 Activity
- 参数：
/ [--ez ] - 示例：
start-activity com.example/.MainActivity --ez test 123 -
input-text- 功能：在设备上输入文本
- 参数：
- 示例：
input-text Hello, World! -
click- 功能：模拟在设备上的点击操作
- 参数：
- 示例：
click 500 1200 -
screenshot- 功能：截取设备屏幕
- 参数：无
- 示例：
screenshot /path/to/screenshot.png -
logcat- 功能：获取设备的日志信息
- 参数：
[--pid] [--time] - 示例：
logcat --pid 1234
📦 安装指南
步骤说明：
# 克隆仓库
git clone [repository-url]
cd mcp-server-adb
# 安装依赖
npm install
# 构建项目
npm run build
在 Claude Desktop 中配置
编辑 claude_desktop_config.json 文件，添加以下内容：
{
"mcpServers": {
"adb": {
"command": "node",
"args": ["-y", "/path/to/mcp-server-adb/build/index.js", "/path/to/adb"]
}
}
}
请将 /path/to/adb 替换为你实际的 ADB 可执行文件路径。
在 Windsurf 中配置
- 确保已安装 Node.js 和 ADB
- 克隆并构建项目：
git clone https://github.com/jiantao88/android-mcp-server.git
cd android-mcp-server
npm install
npm run build
- 在 Windsurf 的设置中添加 MCP 配置：
{
"mcpServers": {
"adb": {
"command": "node",
"args": [
"/path/to/android-mcp-server/build/index.js",
"/usr/local/bin/adb"
]
}
}
}
⚠️ 重要提示
- 将所有路径替换为你的实际路径
/usr/local/bin/adb是 ADB 的默认安装位置，根据实际情况调整
- 重启 Windsurf 以应用配置
📄 许可证
本项目采用 MIT 许可证 - 详见 LICENSE 文件。