loading…
Search for a command to run...
loading…
An MCP server that enables AI assistants to capture and analyze HTTP/HTTPS traffic from Android devices. It supports smart searching of network requests and pro
An MCP server that enables AI assistants to capture and analyze HTTP/HTTPS traffic from Android devices. It supports smart searching of network requests and provides tools for detailed traffic analysis via natural language.
基于 MCP (Model Context Protocol) 的 Android 抓包服务,让 AI 助手能够帮你抓取和分析 HTTP/HTTPS 流量。
┌─────────────────┐ SQLite ┌─────────────────┐
│ 代理服务 │ ─────────────→ │ MCP 服务 │
│ (终端手动启动) │ 流量数据共享 │ (Claude 调用) │
│ mitmdump │ │ 查询/搜索/分析 │
└─────────────────┘ └─────────────────┘
↑
│ HTTP/HTTPS
│
┌─────────┐
│ 手机 │
└─────────┘
安装 uv:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 或通过 pip
pip install uv
# 克隆项目
git clone https://github.com/yourname/android-proxy-mcp.git
cd android-proxy-mcp
# 安装依赖
uv sync
编辑 Claude Desktop 配置文件:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"android-proxy": {
"command": "uv",
"args": ["--directory", "/path/to/android-proxy-mcp", "run", "android-proxy-mcp"]
}
}
}
将
/path/to/android-proxy-mcp替换为实际项目路径
配置完成后,重启 Claude Desktop 使配置生效。
在终端中运行:
uv run android-proxy-start
你会看到如下输出:
╔════════════════════════════════════════════════════════════╗
║ 🚀 Android Proxy MCP 启动向导 ║
╚════════════════════════════════════════════════════════════╝
════════════════════════════════════════════════════════════
环境检测
════════════════════════════════════════════════════════════
✓ 端口 8288 可用
════════════════════════════════════════════════════════════
手机配置
════════════════════════════════════════════════════════════
手机 Wi-Fi 代理设置:
┌─────────────────────────────────┐
│ 服务器: 192.168.1.100 │
│ 端 口: 8288 │
└─────────────────────────────────┘
证书安装: 手机浏览器访问 http://mitm.it
════════════════════════════════════════════════════════════
启动代理 (Ctrl+C 停止)
════════════════════════════════════════════════════════════
保持这个终端窗口运行,不要关闭。
确保手机和电脑在同一 Wi-Fi 网络下。
http://mitm.it(通过代理访问)⚠️ 注意: Android 7+ 用户证书默认不被 App 信任,只能抓取浏览器和部分应用的 HTTPS 流量。
如果你的设备已 Root(安装了 Magisk),可以将用户证书移动为系统证书:
resources/MoveCertificate-v1.5.5.zip Magisk 模块:resources/MoveCertificate-v1.5.5.zip打开 Claude Desktop,用自然语言查询流量:
基础查询:
"显示最近的网络请求" "显示 api.example.com 的请求" "显示所有失败的请求(状态码 4xx 或 5xx)"
搜索内容:
"搜索响应中包含 '张三' 的请求" "搜索 URL 中包含 search 的请求" "搜索请求头中包含 X-Token 的请求"
查看大响应:
"读取 req-5 的响应体" "继续读取 req-5 响应体,从 4000 开始"
智能分析:
"帮我找酷安 app 的搜索接口" "分析这个 API 的请求参数"
在运行代理的终端窗口按 Ctrl+C 停止代理。
记得在手机 Wi-Fi 设置中关闭代理。
| 工具 | 说明 |
|---|---|
proxy_status |
获取代理状态 |
traffic_list |
列出流量(支持域名/状态码/类型筛选) |
traffic_search |
搜索流量内容(URL/请求头/请求体/响应头/响应体) |
traffic_get_detail |
获取请求元数据(请求头、响应头等) |
traffic_read_body |
分片读取大响应体 |
traffic_clear |
清空流量记录 |
get_cert_info |
获取证书安装指南 |
需要安装 CA 证书。手机浏览器访问 http://mitm.it 下载安装。
推荐使用 LSPosed + 禁用 SSL 验证插件:
使用 traffic_search 搜索关键词定位,然后用 traffic_read_body 分片读取。
android-proxy-mcp/
├── README.md
├── pyproject.toml
├── src/
│ └── android_proxy_mcp/
│ ├── cli/ # 命令行工具
│ │ └── start.py # 代理启动脚本
│ ├── core/ # 核心模块
│ │ └── sqlite_store.py # SQLite 流量存储
│ ├── tools/ # MCP 工具
│ └── server.py # MCP 服务入口
├── tests/
├── docs/ # 文档
└── resources/ # 资源文件
└── MoveCertificate-v1.5.5.zip # 证书移动模块
# 安装开发依赖
uv sync --extra dev
# 运行测试
uv run pytest tests/ -v
# 代码格式化
uv run ruff format .
MIT License
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"android-proxy-mcp": {
"command": "npx",
"args": []
}
}
}