Allows controlling Android devices through ADB, including listing devices, running Airtest scripts, capturing screenshots, tapping, swiping, sending key events, and starting or stopping apps.
Allows controlling iOS devices via a WebDriverAgent endpoint, including running Airtest scripts, capturing screenshots, tapping, swiping, and starting or stopping apps.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@airtest-mcp list connected Android devices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A local Model Context Protocol server that lets MCP clients operate the portable AirtestIDE runner on Android, iOS and Windows.
The project does not bundle AirtestIDE, ADB, WebDriverAgent or any NetEase binaries. Download AirtestIDE separately from its official distribution and point this server at the extracted directory.
Tool | Purpose |
| Show the detected AirtestIDE runtime |
| Enumerate devices through bundled ADB |
| Run an existing |
| Run trusted inline Airtest Python |
| Capture a device screenshot |
| Tap an absolute coordinate |
| Swipe between coordinates |
| Send an Android-oriented key event |
| Start an Android package or iOS bundle ID |
| Stop an Android package or iOS bundle ID |
Related MCP server: MCP Appium Server
Windows 10/11
Python 3.11 or newer
Portable AirtestIDE extracted locally
Android: USB debugging or network ADB
iOS: a signed and running WebDriverAgent endpoint
git clone https://github.com/Heand-Broken/airtest-mcp.git
cd airtest-mcp
.\scripts\install_codex.ps1 -AirtestIdeRoot "F:\AirtestIDE"Restart Codex after installation. The installer creates an isolated virtual
environment, installs the package, backs up ~/.codex/config.toml, and adds:
[mcp_servers.airtest]
command = 'C:\Users\you\.codex\mcp\airtest-mcp\.venv\Scripts\python.exe'
args = [ '-m', 'airtest_mcp' ]
[mcp_servers.airtest.env]
AIRTEST_IDE_ROOT = 'F:\AirtestIDE'
AIRTEST_MCP_RUNS_DIR = 'C:\Users\you\AppData\Local\airtest-mcp\runs'Ready-to-edit service configurations are included for multiple clients:
config/codex.toml.example
config/claude_desktop_config.json.example
config/stdio-server.json.example
See docs/configuration.md for installation paths, environment variables and
service verification.
Variable | Required | Purpose |
| Yes, unless auto-detected | Directory containing |
| No | Directory for generated temporary |
Start from .env.example when configuring a shell or local development
environment. MCP clients should normally place these values in the server's
env object instead.
Android:///SERIAL
iOS:///http://127.0.0.1:8100
Windows:///Run list_android_devices first, then build the Android URI from the returned
serial. iOS requires WebDriverAgent to be deployed and reachable before Airtest
can connect.
python -m venv .venv
.\.venv\Scripts\python -m pip install -e ".[dev]"
.\.venv\Scripts\ruff check .
.\.venv\Scripts\pytest
.\.venv\Scripts\python scripts\verify_mcp.pyrun_airtest_code executes Python inside the local Airtest runner. Keep the MCP
server on stdio and only invoke code from trusted clients. Use automation only
on applications, devices and accounts you control or are authorized to test.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for Appcircle mobile CI/CD platform.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP (Model Context Protocol) server for Appwrite
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Heand-Broken/airtest-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server