安卓模拟器MCP服务器-完整实现
此目录包含一个完整的、生产就绪的MCP服务器，用于Android模拟器交互。
📦 你有什么
功能齐全的MCP服务器，具有：
- ✅ 25+设备控制工具
- ✅ 完整的文件（7份文件）
- ✅ 辅助脚本（证书安装程序、测试程序）
- ✅ Docker部署就绪
- ✅ 包含测试套件
- ✅ ~1500行代码
- ✅ 自动设置脚本 -只需一个命令即可设置所有内容！
🚀 快速设置
自动设置（推荐）
先决条件：
- Python 3.10+(
brew install python@3.11在macOS上） - ADB(
brew install android-platform-tools在macOS上） - Android模拟器正在运行（在Android Studio中启动）
在一个命令中设置：
./setup.sh脚本将：
- 检查先决条件（Python、ADB、模拟器）
- 创建虚拟环境
- 安装依赖项
- 运行测试
- 自动配置克劳德桌面
- 创建辅助脚本(
run_tests.sh,start_server.sh)
在设置完成之后， 重新启动克劳德桌面 并尝试：
"Take a screenshot of my Android emulator"手动设置
# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Test it works
python test_functionality.py
# Configure Claude Desktop manually
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
# Add MCP server configuration (see QUICKSTART.md)
# Start the server
python server.py📚 文档指南
| 文件 | 内容 | 读取时间 |
|---|---|---|
| INDEX.md | 主导航 | 需要找到一些东西 |
| 项目\_ SUMMARY.md | 完整概述 | 第一次在这里 |
| QUICKSTART.md | 5分钟设置 | 立即开始 |
| 快速引用.md | 备忘单 | 使用工具 |
| README.md | 完整文档 | 需要所有详细信息 |
| 示例.md | 实际工作流程 | 学习模式 |
| ADVANCED.md | 电源功能 | 想要更多 |
| 建筑.md | 系统设计 | 了解内部 |
🎯 你能做什么？
安全性测试
- 设置mitmproxy或Burp Suite
- 拦截HTTPS流量
- 安装CA证书
- 分析API调用
自动化测试
- 安装并测试APK
- 浏览应用程序
- 填写表格并登录
- 屏幕截图验证
UI探索
- 捕获所有屏幕
- 地图导航流程
- 文档UI元素
- 查找可访问性问题
发展
- 测试你的应用程序
- 调试问题
- 自动化工作流程
- 与CI/CD集成
🛠️ 关键文件
核心实施
- 服务器.py （850行）-配备所有25+工具的MCP服务器
- 需求.txt -Python依赖关系
- setup.py -软件包配置
助手脚本
- cert_installer.py （260行）-自动安装证书
- test_functionality.py （400行）-综合测试套件
- 生成文件 -常用命令
部署
- Dockerfile -容器图片
- docker-compose.yml -堆栈编排
配置
- claude_desktop_config json -Claude集成模板
- 微笑。 -Git排除
⚡ 快速命令
# Test everything works
python test_functionality.py
# Start the server
python server.py
# Install mitmproxy cert
python cert_installer.py ~/.mitmproxy/mitmproxy-ca-cert.pem
# Use Makefile shortcuts
make help # See all commands
make test # Run tests
make install-cert # Install cert🎓 学习路径
初级（15分钟）
- 阅读项目_SUMMARY.md
- 运行test_functionity.py
- 尝试示例.md中的一个示例
中级（1小时）
- 完成QUICKSTART.md
- 配置Claude桌面
- 测试3-4个工作流程
- 为应用程序设置代理
高级（半天）
- 阅读ARCHITECTURE.md
- 研究进展md
- 与Frida/Burp集成
- 构建自定义工作流
🔐 安全警告
⚠️ 这提供了完整的设备控制！
仅适用于：
- ✅ 测试装置
- ✅ 开发模拟器
- ✅ 您拥有的设备
- ✅ 本地网络
切勿在以下情况下使用：
- ❌ 生产设备
- ❌ 其他人的设备
- ❌ 公共网络
- ❌ 敏感环境
📊 项目统计
Files: 17 total
Documentation: 8 files (50KB)
Code: 3 files (60KB)
Scripts: 3 helpers
Config: 3 files
Lines of Code: ~1,500
Tools: 25+
Examples: 6+ workflows
Tests: 10 categories🆘 需要帮助？
快速故障排除
# Is ADB working?
adb devices
# Is emulator running?
adb shell ls
# Is Python setup correct?
python test_functionality.py
# Need more help?
open QUICKSTART.md # Troubleshooting section常见问题
- “未找到设备”→ 启动模拟器
- “未找到ADB”→ 安装安卓SDK
- “测试失败”→ 检查QUICKSTART.md
- “设备脱机”→ 重新启动模拟器
💡 接下来是什么？
开始之后：
- 请尝试以下示例 -示例.md有6+个工作流
- 阅读高级文档 -ADVANCED.md用于电源功能
- 集成工具 -弗里达、波普、OpenCV
- 构建工作流 -自动化您的测试
- 贡献 -改进和扩展！
🎉 你准备好了！
这是一个完整的、生产就绪的实现。您需要的一切都在这里：
- ✅ 完整MCP服务器
- ✅ 25+工具
- ✅ 完整文档
- ✅ 辅助脚本
- ✅ 测试套件
- ✅ 示例工作流
- ✅ 部署配置
从QUICKSTART.md开始，您将在5分钟内跑步！
______________________________________________________________________
有关详细导航，请参阅 INDEX.md