androidMcpServer

🚀 ADB MCP 服务器

这是一个用于 Android 调试桥接 (ADB) 的 MCP 服务器，借助它，Claude 能够与 Android 设备进行交互。

📚 技术文章

• 从 0 到 1 开发一个 Android MCP 服务：理解 MCP 协议与 ADB 集成

✨ 主要特性

工具列表

1. get-devices

   • 功能：列出已连接的 Android 设备
   • 参数：无
   • 示例输出：

   List of devices attached
   0a00000000000000	设备名称	model	number
   

2. install-apk

   • 功能：在设备上安装 APK 文件
   • 参数：<apk-path>
   • 示例：

   install-apk /path/to/app.apk
   

3. uninstall-apk

   • 功能：从设备上卸载应用程序
   • 参数：<package-name>
   • 示例：

   uninstall-apk com.example.app
   

4. start-activity

   • 功能：启动指定的 Activity
   • 参数：<package-name>/<action> [--ez <name> <value>]
   • 示例：

   start-activity com.example/.MainActivity --ez test 123
   

5. input-text

   • 功能：在设备上输入文本
   • 参数：<text>
   • 示例：

   input-text Hello, World!
   

6. click

   • 功能：模拟在设备上的点击操作
   • 参数：<x> <y>
   • 示例：

   click 500 1200
   

7. screenshot

   • 功能：截取设备屏幕
   • 参数：无
   • 示例：

   screenshot /path/to/screenshot.png
   

8. logcat

   • 功能：获取设备的日志信息
   • 参数：[--pid <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 中配置

1. 确保已安装 Node.js 和 ADB
2. 克隆并构建项目：

git clone https://github.com/jiantao88/android-mcp-server.git
cd android-mcp-server
npm install
npm run build

3. 在 Windsurf 的设置中添加 MCP 配置：

{
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": [
        "/path/to/android-mcp-server/build/index.js",
        "/usr/local/bin/adb"
      ]
    }
  }
}

⚠️ 重要提示

• 将所有路径替换为你的实际路径
• /usr/local/bin/adb 是 ADB 的默认安装位置，根据实际情况调整

4. 重启 Windsurf 以应用配置

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。