Minhalvp Android MCP Server

🚀 Android MCP 服务器

Android MCP 服务器是一个借助 ADB（Android 调试桥接）实现对安卓设备进行程序化控制的 MCP (模型上下文协议) 服务器。它开放了多种安卓设备管理功能，可通过 MCP 客户端（如 Claude 桌面）和代码编辑器（如 Cursor）进行访问。

✨ 主要特性

• 🔧 执行 ADB 命令
• 📸 捕获设备屏幕截图
• 🎯 分析 UI 布局
• 📱 管理设备包

📦 安装指南

先决条件

• Python 3.x
• 已安装并配置好的 ADB (Android Debug Bridge)
• 安卓设备或模拟器（未经过测试）

安装步骤

1. 克隆仓库：

git clone https://github.com/minhalvp/android-mcp-server.git
cd android-mcp-server

2. 安装依赖项： 此项目使用 uv 进行项目管理，可通过多种方式安装。

uv python install 3.11
uv sync

📚 详细文档

配置

服务器采用一个简单的 YAML 配置文件 (config.yaml) 来指定目标安卓设备。

自定义配置

1. 创建一个新的配置文件：

touch config.yaml

2. 配置你的设备：

device:
  name: "google-pixel-7-pro:5555" # 你从 'adb devices' 得到的设备标识符

使用说明

需要一个 MCP 客户端才能使用此服务器，Claude 桌面应用就是一个例子。要与 Claude 桌面一起使用此服务器，可按以下步骤操作：

1. 找到你的 Claude 桌面配置文件：
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. 将 Android MCP 服务器配置添加到 mcpServers 部分：

{
  "mcpServers": {
    "android": {
      "command": "path/to/uv",
      "args": ["--directory", "path/to/android-mcp-server", "run", "server.py"]
    }
  }
}

替换：

• path/to/uv 为你实际的 uv 可执行文件路径
• path/to/android-mcp-server 为你克隆此仓库的实际绝对路径

可用工具

服务器公开了以下工具：

def get_packages() -> str:
    """
    获取设备上所有已安装的包。
    返回：
        str: 设备上所有已安装包的字符串列表
    """

def execute_adb_command(command: str) -> str:
    """
    执行 ADB 命令并返回结果。
    参数：
        command (str): 要执行的 ADB 命令
    返回：
        str: 命令的输出结果
    """

def analyze_ui_layout() -> None:
    """
    分析并捕获当前设备的 UI 布局。
    """

def get_screen_shot() -> Image:
    """
    捕获设备屏幕截图并返回为 Image 对象。
    返回：
        Image: 屏幕截图的 Image 对象
    """

🤝 贡献

我们欢迎社区贡献！如果你有任何问题或建议，请随时在 GitHub 提交问题或拉取请求。

🙏 致谢

感谢你使用 Android MCP 服务器。此项目基于 MCP 协议 开发，旨在为安卓设备提供更强大的控制和管理能力。