npm @kaeawc/auto-mobilestdioApache-2.0updated 8d ago
AutoMobile lets AI agents control your mobile devices using natural language. Tell an AI what you want to do, and it interacts with your Android or iOS app.
AutoMobile 能做什么?
AutoMobile

AutoMobile lets AI agents control your mobile devices using natural language. Tell an AI what you want to do, and it interacts with your Android or iOS app.
It can do all this by being an MCP server that uses standard platform tools like adb & simctl paired with additional Kotlin & Swift libraries and apps. All components are open source. The point is to provide mobile engineers with AI workflow tools to perform UX deep dives, reproduce bugs, and run automated tests.
An AI agent navigating to the Clock app, creating a new alarm
An AI agent searching YouTube and browsing results
Explore and Test
| Task | What it does |
|---|---|
| Explore app UX | Navigate your app, discover screens, map user flows, identify confusing interactions |
| Reproduce bugs | Paste a bug report and get exact reproduction steps with screenshots |
| Create UI tests | Describe test scenarios in plain English, get executable test plans |
| Measure startup time | Profile cold and warm launch performance |
| Check scroll performance | Detect jank and dropped frames |
How it works
- 🤖 Fast UX Inspection Kotlin Accessibility Service and Swift XCTestService to enable fast, accurate observations. 10x faster than the next fastest observation toolkit.
- 🦾 Full Touch Injection Tap, Swipe, Pinch, Drag & Drop, Shake with automatic element targeting.
- ♻️ Tool Feedback Observations drive the interaction loop for all tool calls.
- 🧪 Test Execution Kotlin JUnitRunner & Swift XCTestRunner execute tests natively handling device pooling, multi-device tests, and automatically optimizing test timing.
Get Started
You can use our interactive installer to step through all host platform requirements and configuration options. It checks host dependencies, optionally downloads Android or iOS developer tools, and configured the MCP daemon.
curl -fsSL https://raw.githubusercontent.com/kaeawc/auto-mobile/refs/heads/main/scripts/install.sh | bash
or follow the installation guide.
Documentation
- Full Documentation - Complete guide with examples
- FAQ - Common questions answered
- Design Docs - Architecture and implementation details
Contributing
- Code of Conduct
- Please report security vulnerabilities via GitHub
- Contributing
安装
把 AutoMobile 添加到你的客户端。选择你正在使用的那个。
claude mcp add auto-mobile -- npx -y @kaeawc/auto-mobilecodex mcp add auto-mobile -- npx -y @kaeawc/auto-mobileamp mcp add auto-mobile -- npx -y @kaeawc/auto-mobile{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"auto-mobile","command":"npx","args":["-y","@kaeawc/auto-mobile"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"auto-mobile": {
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"auto-mobile": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"auto-mobile": {
"command": {
"path": "npx",
"args": [
"-y",
"@kaeawc/auto-mobile"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @kaeawc/auto-mobileRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
评分
39 / 100
不完整
- 文档25/25
- 维护25/25
- 可信度13/20
- 能力0/15
- 安装体验12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 0 days ago
- Has a release history
- Repository is not archived
- Licensed Apache-2.0
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 0.0.67最新 | 2026年8月30日 |
| 0.0.66 | 2026年8月27日 |
| 0.0.65 | 2026年8月27日 |
| 0.0.64 | 2026年8月25日 |
| 0.0.63 | 2026年8月24日 |
| 0.0.62 | 2026年8月23日 |
| 0.0.61 | 2026年8月22日 |
| 0.0.60 | 2026年8月19日 |
| 0.0.59 | 2026年8月19日 |
| 0.0.58 | 2026年8月15日 |
| 0.0.57 | 2026年8月14日 |
| 0.0.56 | 2026年8月14日 |
| 0.0.55 | 2026年8月13日 |
| 0.0.53 | 2026年8月11日 |
| 0.0.52 | 2026年8月10日 |
| 0.0.51 | 2026年8月9日 |
| 0.0.50 | 2026年8月3日 |
| 0.0.49 | 2026年8月3日 |
| 0.0.48 | 2026年8月1日 |
| 0.0.47 | 2026年7月31日 |
| 0.0.13 | 2026年2月13日 |