Chopper
No description available
Install / Use
/learn @carlosadrianosj/ChopperREADME
<a id="english"></a>
What is Chopper?
Chopper is a Rust-native MCP (Model Context Protocol) server that gives AI assistants like Claude direct access to Android devices through ADB and iOS virtual machines on macOS. It runs over STDIO and exposes 58 Android tools + 32 iOS VM tools (macOS only) covering the full surface for reverse engineering, app manipulation, MITM interception, and Frida instrumentation.
See docs/en/android/ for the full Android tool reference, docs/en/ios/ for iOS VM tools, and docs/en/mcp-with-agents/ for guidance on using Chopper with AI agents.
Note: iOS VM tools are under active development and may change between releases. Refer to the iOS documentation for the latest supported capabilities.
Build
git clone https://github.com/carlosadrianosj/Chopper.git
cd Chopper
cargo build --release
The binary will be at target/release/chopper-server.
Setup
Claude Code (CLI)
Create a .mcp.json file in your project root (the directory where you run claude):
{
"mcpServers": {
"chopper": {
"command": "/absolute/path/to/target/release/chopper-server",
"args": []
}
}
}
Then restart Claude Code or start a new session. The tools will appear as mcp__chopper__chopper_android_devices, etc.
You can also register it globally via claude mcp add:
claude mcp add chopper /absolute/path/to/target/release/chopper-server
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"chopper": {
"command": "/absolute/path/to/target/release/chopper-server",
"args": []
}
}
}
Replace /absolute/path/to/target/release/chopper-server with the actual path to the compiled binary.
Configuration (optional)
Chopper looks for a config file at ~/.chopper/chopper.toml. If it doesn't exist, defaults are used.
[server]
name = "chopper"
log_level = "info"
[adb]
server_address = "127.0.0.1:5037"
Usage Examples
Android:
- "List all connected devices" calls
chopper_android_devices - "Show me all third-party packages" calls
chopper_android_packages - "Take a screenshot" calls
chopper_android_screenshot - "Get app info for com.example.app" calls
chopper_android_app_info - "Set up MITM interception" calls
chopper_android_mitm_setup - "Run Frida recon on com.target.app" calls
chopper_android_frida_scripts - "Show me the logcat for com.example.app" calls
chopper_android_logcat - "Grant camera permission to com.example.app" calls
chopper_android_grant_permission
iOS VM (macOS only):
- "Boot the iOS VM" calls
chopper_ios_emulator_start - "Find the VM IP" calls
chopper_ios_emulator_discover_ip - "Run uname on the iOS VM" calls
chopper_ios_emulator_ssh_exec - "List apps on the iOS VM" calls
chopper_ios_emulator_list_apps - "Take a screenshot of the iOS VM" calls
chopper_ios_emulator_screenshot
For the full tool reference, see
docs/en/android/for Android,docs/en/ios/for iOS VM tools, anddocs/en/mcp-with-agents/for agent integration guides.
<a id="中文"></a>
Chopper 是什么？
Chopper 是一个 Rust 原生的 MCP (Model Context Protocol) 服务器，让 Claude 等 AI 助手能够通过 ADB 直接访问 Android 设备，以及在 macOS 上操控 iOS 虚拟机。它通过 STDIO 运行，提供 58 个 Android 工具 + 32 个 iOS VM 工具（仅限 macOS），涵盖逆向工程、应用操控、MITM 拦截和 Frida 插桩的完整功能。
完整的 Android 工具参考请查看 docs/zh/android/，iOS VM 工具请查看 docs/zh/ios/，AI Agent 集成指南请查看 docs/zh/mcp-with-agents/。
注意： iOS VM 工具仍在积极开发中，可能会在不同版本间发生变化。请参阅 iOS 文档了解最新支持的功能。
构建
git clone https://github.com/carlosadrianosj/Chopper.git
cd Chopper
cargo build --release
编译后的二进制文件位于 target/release/chopper-server。
配置连接
Claude Code（命令行）
在项目根目录（运行 claude 的目录）创建 .mcp.json 文件：
{
"mcpServers": {
"chopper": {
"command": "/absolute/path/to/target/release/chopper-server",
"args": []
}
}
}
然后重启 Claude Code 或开始新会话。工具将以 mcp__chopper__chopper_android_devices 等形式出现。
也可以通过 claude mcp add 全局注册：
claude mcp add chopper /absolute/path/to/target/release/chopper-server
Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"chopper": {
"command": "/absolute/path/to/target/release/chopper-server",
"args": []
}
}
}
将 /absolute/path/to/target/release/chopper-server 替换为编译后二进制文件的实际路径。
配置文件（可选）
Chopper 会查找 ~/.chopper/chopper.toml 配置文件。如果文件不存在，则使用默认值。
[server]
name = "chopper"
log_level = "info"
[adb]
server_address = "127.0.0.1:5037"
使用示例
Android：
- "列出所有已连接设备" 调用
chopper_android_devices - "显示所有第三方应用" 调用
chopper_android_packages - "截图" 调用
chopper_android_screenshot - "获取 com.example.app 的应用信息" 调用
chopper_android_app_info - "设置 MITM 拦截" 调用
chopper_android_mitm_setup - "对 com.target.app 运行 Frida 侦察" 调用
chopper_android_frida_scripts - "显示 com.example.app 的日志" 调用
chopper_android_logcat - "授予 com.example.app 相机权限" 调用
chopper_android_grant_permission
iOS VM（仅限 macOS）：
- "启动 iOS 虚拟机" 调用
chopper_ios_emulator_start - "查找虚拟机 IP" 调用
chopper_ios_emulator_discover_ip - "在 iOS 虚拟机上运行 uname" 调用
chopper_ios_emulator_ssh_exec - "列出 iOS 虚拟机上的应用" 调用
chopper_ios_emulator_list_apps - "对 iOS 虚拟机截图" 调用
chopper_ios_emulator_screenshot
完整工具参考请查看：Android 工具
docs/zh/android/，iOS VM 工具docs/zh/ios/，Agent 集成指南docs/zh/mcp-with-agents/。
