安卓MCP服务器
概述
此存储库提供 用于Android设备控制的MCP（模型上下文协议）服务器 通过ADB（安卓调试桥）。它公开了可以从LLM或客户端（如Claude Desktop）调用的简单工具（函数），以自动执行Android设备操作，如打开Chrome和执行搜索。
目标是让任何支持MCP的客户端（如Claude Desktop）都能使用自然语言和安全、可审计的工具轻松控制Android设备。
______________________________________________________________________
特性
- open_chrome_and_search:\
在连接的Android设备上打开默认浏览器，并对给定的查询执行谷歌搜索。
- 屏幕截图_和预处理:\
截取屏幕截图并对其进行预处理以供进一步使用。
- send_sms_via_adb:\
通过ADB向指定号码发送短信。
- get_device_model:\
检索连接的Android设备的型号名称。
- 获取电池信息:\
返回电池状态和信息。
- get_device_features:\
列出设备支持的硬件/软件功能。
- get_storage_info:\
提供有关设备存储使用情况的信息。
- get_network_info:\
返回有关设备网络连接的详细信息。
- take_screenshot:\
从设备中捕获屏幕截图。
- 打开设置:\
打开设备上的主设置应用程序。
- toggle_airplane_mode:\
启用或禁用飞行模式。
- 增加音量/减少音量:\
调整设备的媒体音量。
- 按下电源按钮:\
模拟按下电源按钮。
- 按下主页按钮:\
模拟按下主页按钮。
- 按下返回按钮:\
模拟按下后退按钮。
- open_wifi_设置:\
打开Wi-Fi设置屏幕。
- 开放式蓝牙设置:\
打开蓝牙设置屏幕。
- open_display_settings:\
打开显示设置屏幕。
- 易于扩展：根据需要添加更多ADB驱动的工具（启动应用程序、截图等）
- 安全：只公开特定的白名单操作。
______________________________________________________________________
需求
- Python 3.10+
- ADB公司 已安装并添加到系统PATH
- 具有以下功能的Android设备：
- 开发人员模式已启用 - USB调试已启用
______________________________________________________________________
安装和设置
1.克隆存储库
git clone https://github.com/IngaleChinmay04/android-mcp-server
cd android-mcp-server2.安装 紫外线 （如果还没有）
在Windows（PowerShell）上：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"在Mac/Linux上：
curl -LsSf https://astral.sh/uv/install.sh | sh安装后重新启动终端。
3.设置Python环境
uv venv
# On Windows:
.venv\Scripts\activate
# On Mac/Linux:
source .venv/bin/activate
uv add "mcp[cli]"4.（可选）手动测试服务器
uv run android_server.py服务器将等待MCP客户端连接。
______________________________________________________________________
用途：与Claude Desktop集成
要将MCP服务器连接到Claude Desktop，请执行以下操作：
1.确保 克劳德桌面 已安装和 完全更新.
2.编辑/创建Claude配置文件
在Windows上：
- 地点：\
C:\Users\\AppData\Roaming\Claude\claude_desktop_config.json
在Mac上：
- 地点：\
~/Library/Application Support/Claude/claude_desktop_config.json
如果文件不存在，则创建该文件。
3.添加服务器配置
示例配置（如果克隆到其他位置，请更新目录路径）：
{
"mcpServers": {
"android_control": {
"command": "uv",
"args": [
"--directory",
"C:\\Users\\\\Desktop\\android-mcp-server",
"run",
"android_server.py"
]
}
}
}- 使用项目文件夹的绝对路径。
- 保存配置文件。
4.重新启动克劳德桌面
- 完全关闭所有Claude Desktop窗口（包括托盘图标）。
- 重新打开克劳德桌面。
5.插入您的Android设备
- 在手机上启用开发人员选项和USB调试。
- 通过USB连接。
- 批准任何“允许USB调试”提示。
______________________________________________________________________
示例用法
在Claude Desktop中，您现在可以通过键入自然语言提示符来使用该工具，例如：
- “在我的安卓设备上搜索‘最新安卓新闻’。”
- “使用open_chrome_and_search工具查询：Python教程”
Claude将调用该工具，您的手机浏览器将打开并执行搜索。
______________________________________________________________________
添加更多工具
要扩展功能，只需添加更多 @mcp.tool() 装饰Python函数 android_server.py.\ 例如，您可以添加工具来截图、安装应用程序、打开特定应用程序等。
______________________________________________________________________
故障排除
- 找不到设备？\
确保你已经跑过了 adb devices 并查看您的设备列表。
- MCP服务器未在Claude中显示？\
仔细检查您的配置文件路径和语法，然后重新启动Claude Desktop。
- 意外的令牌/JSON错误？\
确保服务器代码中没有打印语句或记录到stdout；所有输出必须仅通过MCP调用。
- 还在卡住吗？\
有关详细信息，请查看Claude日志（Claude Desktop UI中的按钮）。
______________________________________________________________________
鸣谢
______________________________________________________________________