MobiLoop — Claude Code MCP server: what it does, install
MobiLoop gives an AI coding agent guarded tools for mobile builds, Appium runs, security checks, and evidence-based failure reports.
claude mcp add --env MOBILOOP_WORKSPACE_ROOT=<MOBILOOP_WORKSPACE_ROOT> --env APPIUM_SERVER_URL=<APPIUM_SERVER_URL> --transport stdio mobiloop -- docker run -i --rm -e MOBILOOP_WORKSPACE_ROOT -e APPIUM_SERVER_URL ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15What MobiLoop does
MobiLoop connects an MCP client to a real mobile development setup. It can inspect and patch a workspace, build the app, install it on an Android or iOS target, drive it with Appium, and check logs, screenshots, page source, and API responses. The result is a report backed by tool output rather than an agent claim.
The server separates Android and iOS tools, stores screen checkpoints, replays stable setup paths, and runs JSON flows with waits, taps, typing, assertions, and evidence steps. It also scans Flutter, React Native, Android, and iOS source for possible end-to-end scenarios. High-impact tools use an approval gate, while common secrets are redacted from text artifacts.
MobiLoop does not replace the Android SDK, Xcode, Appium, or platform drivers. iOS simulator work requires macOS, and Appium must be running before Appium or flow-replay tools are used.
What it helps with
- build and install a mobile app on a target
- run an Appium UI flow with captured evidence
- collect logs, screenshots, and page source
- classify failures from runtime evidence
- scan mobile settings for security issues
Example prompts for the agent
- Build the mobile app, install it on a target, and run an Appium check with evidence.
- Scan the Flutter and Android source for candidate end-to-end scenarios.
- Compare logs, screenshots, and API responses, then classify the failure and write a report.
How to install MobiLoop
Platform CLI
claude mcp add --env MOBILOOP_WORKSPACE_ROOT=<MOBILOOP_WORKSPACE_ROOT> --env APPIUM_SERVER_URL=<APPIUM_SERVER_URL> --transport stdio mobiloop -- docker run -i --rm -e MOBILOOP_WORKSPACE_ROOT -e APPIUM_SERVER_URL ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15Replace <…> with your own values
Platform CLI
codex mcp add mobiloop --env MOBILOOP_WORKSPACE_ROOT=<MOBILOOP_WORKSPACE_ROOT> --env APPIUM_SERVER_URL=<APPIUM_SERVER_URL> -- docker run -i --rm -e MOBILOOP_WORKSPACE_ROOT -e APPIUM_SERVER_URL ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15Replace <…> with your own values
Config file
{
"mcpServers": {
"mobiloop": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MOBILOOP_WORKSPACE_ROOT",
"-e",
"APPIUM_SERVER_URL",
"ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15"
],
"env": {
"MOBILOOP_WORKSPACE_ROOT": "<MOBILOOP_WORKSPACE_ROOT>",
"APPIUM_SERVER_URL": "<APPIUM_SERVER_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mobiloop": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MOBILOOP_WORKSPACE_ROOT",
"-e",
"APPIUM_SERVER_URL",
"ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15"
],
"env": {
"MOBILOOP_WORKSPACE_ROOT": "<MOBILOOP_WORKSPACE_ROOT>",
"APPIUM_SERVER_URL": "<APPIUM_SERVER_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MOBILOOP_WORKSPACE_ROOT=<MOBILOOP_WORKSPACE_ROOT> -e APPIUM_SERVER_URL=<APPIUM_SERVER_URL> mobiloop docker run -i --rm -e MOBILOOP_WORKSPACE_ROOT -e APPIUM_SERVER_URL ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15Replace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MobiLoop
How do I install MobiLoop in Claude Code?
Add the MCP server with `claude mcp add --env MOBILOOP_WORKSPACE_ROOT=<MOBILOOP_WORKSPACE_ROOT> --env APPIUM_SERVER_URL=<APPIUM_SERVER_URL> --transport stdio mobiloop -- docker run -i --rm -e MOBILOOP_WORKSPACE_ROOT -e APPIUM_SERVER_URL ghcr.io/enessubass/mobiloop-mcp:0.1.0-alpha.15`.
What does MobiLoop do?
It runs a guarded mobile build-test-verify loop. The agent can build, install, drive the app through Appium, inspect evidence, classify failures, and produce a report.
What does MobiLoop need to run mobile tests?
The MCP runtime needs Node.js 20+. Android targets need the Android SDK, adb, a device or emulator, Appium, and a compatible UiAutomator2 driver; iOS simulator targets need macOS, Xcode, xcrun simctl, Appium, and a compatible XCUITest driver.
