终极安卓MCP🤖
📝 描述
Ultimate Android MCP是一款功能强大、功能多样的MCP（模型上下文协议）服务器，旨在与连接的Android设备进行交互。它提供了广泛的工具和功能，可以在Android设备上执行各种任务，例如管理应用程序、与UI交互、检索设备信息等。该项目旨在提供最广泛的功能，以确保使用模型上下文协议通过LLM进行最佳交互。
✨ 特性
MCP服务器提供以下功能：
📱 应用程序管理
- 检索所有已安装软件包（系统和用户安装）的列表。
- 检索用户安装的应用程序包名称列表。
- 检索系统应用程序包名称列表（预安装的应用程序）。
- 按包名启动应用程序。
- 在已连接的Android设备上安装APK。
- 从设备中卸载指定的程序包。
- 检查设备上是否安装了指定的软件包。
🎮 输入模拟
- 模拟输入事件，如按键、轻击、滑动和文本输入。
- 使用指定的密钥代码模拟密钥事件。
- 在指定的（x，y）坐标处模拟轻击手势。
- 模拟在当前焦点字段中键入文本。
- 使用指定的按键代码模拟按键事件。
- 使用指定的dx和dy值模拟滚动手势。
- 模拟从一个坐标到另一个坐标的滑动手势，持续时间可选。
- 检查虚拟键盘当前是否打开。
- 模拟按下后退按钮。
- 模拟按下主页按钮。
📊 设备信息
- 检索设备特定信息，包括序列号、属性和电池电量。
- 检索连接的Android设备的序列号。
- 检索设备的build.prop属性。
- 检索设备覆盖配置属性。
- 检索设备的电池电量。
- 检索设备的屏幕密度。
- 检索设备的屏幕大小。
🖥️ 系统和性能监控
- 检索CPU信息，如核心计数和负载百分比。
- 检索设备上的CPU核数。
- 检索设备上的当前CPU负载百分比。
- 检索顶级活动和流程。
- 检索指定包名称的进程ID（PID）。
- 检索当前设备顶部的活动。
- 检索当前设备顶部的单个活动。
📂 文件管理
- 管理设备上的文件，包括推送和拉取文件。
- 将文件从连接的Android设备拉到本地计算机。
- 将文件从本地计算机推送到连接的Android设备。
🖱️ UI交互
- 从设备屏幕检索UI元素和聚焦节点。
- 检索设备屏幕上当前可见的UI节点列表，重点关注文本标签和内容描述。
- 检索当前聚焦在设备屏幕上的UI节点列表。
⚙️ 高级操作
- 执行原始ADB shell命令并检索输出。
🎥 演示
通过USB连接的物理设备（运行Android 15的Pixel 7 Pro），其屏幕通过scrcpy共享。使用克劳德桌面版（0.9.2版）。提供给克劳德的案文如下：
In the connected android device, play the song 'mask off' by future on spotify.
然后，克劳德想出了如何启动应用程序，点击哪个按钮，在哪里输入什么文本。演示中的所有内容都是自主的，其间没有用户交互。
https://github.com/user-attachments/assets/5811fcc1-9047-48be-b057-1049754710c0
📋 先决条件
要运行此项目，请确保您具备以下条件：
- Python 3。
- 在您的系统上安装并配置了ADB（Android调试桥）（确保
adb指挥工作）。 - 已连接并启用USB调试的Android设备。
- 这
pure-python-adb库已安装（包含在项目依赖项中）。
⚙️ 安装和设置
按照以下步骤设置项目：
- 克隆存储库：
git clone https://github.com/oddlyspaced/ultimate-android-mcp.git android-mcp
cd android-mcp- 安装所需的库：
默认情况下，此项目使用 uv 但是，对于依赖关系管理，如果你愿意，你可以通过pip安装所需的包。
uv sync或
pip install pure-python-adb
pip install mcp- 通过编辑来配置项目
config.py文件以匹配您的ADB设置和设备详细信息。（更多内容见下一节）
- 跑
doctor.py以确保正确完成设置。
以下是来自 doctor.py 脚本：
Checking device connection using the following configuration:
ADB Client Host: 127.0.0.1
ADB Client Port: 5037
ADB Device Serial: 32241FDH3002EH
Device connected: 32241FDH3002EH
Hello from Android! Ready to use with MCP.🛠️ 配置概述
这 config.py 文件包含以下配置选项：
adb_client_host：ADB服务器的主机地址（默认值：127.0.0.1).adb_client_port：ADB服务器的端口（默认值：5037).adb_device_serial：连接设备的序列号或IP地址。如果未指定，将使用第一个可用设备。
🖥️ 通过Claude MCP配置JSON使用
要使用MCP服务器，您可以通过Claude Desktop MCP配置JSON与之交互。
Claude Desktop配置文件位于以下位置：
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json以下是一个示例配置，使用 uv:
{
"mcpServers": {
"Android MCP": {
"command": "uv",
"args": [
"--directory",
"/Users/hardik/Projects/Android-Agents/android-mcp", // Replace this with your folder path
"run",
"server.py"
]
}
}
}或者用python
{
"mcpServers": {
"Android MCP": {
"command": "python",
"args": [
"/Users/hardik/Projects/Android-Agents/android-mcp/server.py", // Replace this with your folder path
]
}
}
}或者，您可以使用以下命令运行MCP服务器：
python server.py🐞 已知问题
- 经常在连续查询用户界面后，除非重新启动设备，否则结果可能会暂时不可用。这是转储当前UI树的问题。逻辑将很快更新以修复此问题。
💻 使用的技术
- python
- MCP-模型上下文协议
- 纯python adb
贡献者
- 哈迪克·斯里瓦斯塔瓦(奇怪的节奏)
📜 许可证
此项目根据GNU通用公共许可证v3.0获得许可。您可以在以下网址获得许可证副本：
https://www.gnu.org/licenses/gpl-3.0.en.html
本许可证允许您使用、修改和分发软件，前提是任何修改或衍生作品也符合GPL许可证。有关更多详细信息，请参阅许可证文档。