Memungkinkan AI agent untuk berinteraksi dengan iOS Simulator dengan cara membaca layar, melakukan gesture sentuhan, dan memutar ulang alur pengujian di CI.
Juga dikenal sebagai valewnrt/testa, @valewnrt/testa-mcp
- Stars
- 3
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.2.2
- Commit terakhir
- 8 Okt 2026
- Lisensi
- MIT
Apa itu Testa MCP?
Memungkinkan AI agent untuk berinteraksi dengan iOS Simulator dengan cara membaca layar, melakukan gesture sentuhan, dan memutar ulang alur pengujian di CI.
Ringkasan dibuat dari README proyek
Tentang Testa MCP server
Testa memberikan kemampuan kepada AI agent untuk berinteraksi secara langsung dengan iOS Simulator di macOS. Tool ini berfungsi sebagai MCP server yang memberikan kapasitas kepada client seperti Claude Code, Cursor, atau Codex untuk melihat dan memanipulasi antarmuka mobile. Tool ini bekerja dengan membaca accessibility tree dan menggunakan Apple Vision OCR untuk menginterpretasikan layar, sehingga memungkinkan pengoperasian pada aplikasi React Native, Expo, atau SwiftUI tanpa memerlukan perubahan kode atau identifier pengujian khusus.
User menginstal server ini via Homebrew pada Mac yang menjalankan Xcode. Setelah dikonfigurasi, agent dapat melakukan tugas kompleks seperti tapping, mengetik, swiping, atau memutar perangkat. Sistem ini dirancang agar efisien untuk token budget LLM dengan merepresentasikan layar sebagai teks ringkas alih-alih gambar yang berat. Developer juga dapat merekam aksi agent ke dalam flow file untuk diputar ulang di lingkungan CI menggunakan GitHub Action, yang menyediakan output JUnit dan artifact kegagalan tanpa memerlukan model live selama eksekusi.
Apa yang bisa Anda lakukan dengannya
- 1Automated UI testingMinta agent untuk meluncurkan aplikasi dan menyelesaikan alur registrasi pengguna tertentu.
- 2Testing tanpa modifikasi kodeVerifikasi perilaku aplikasi pada layar yang tidak memiliki identifier pengujian yang telah ditentukan sebelumnya.
- 3Continuous Integration replayJalankan interaksi agent yang telah direkam sebelumnya dalam pipeline CI untuk memastikan stabilitas.
- 4Simulasi gesture kompleksInstruksikan AI untuk melakukan interaksi multi-touch seperti pinching atau dragging elemen.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Testa MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Testa MCP di Claude Code
$ claude mcp add testa -- npx -y @valewnrt/testa-mcpInstal Testa MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Instal Testa MCP di VS Code
.vscode/mcp.json
{
"servers": {
"testa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Instal Testa MCP di VS Code CLI
$ code --add-mcp '{"name":"testa","type":"stdio","command":"npx","args":["-y","@valewnrt/testa-mcp"]}'Instal Testa MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Instal Testa MCP di Codex
$ codex mcp add testa -- npx -y @valewnrt/testa-mcpInstal Testa MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.testa] command = "npx" args = ["-y", "@valewnrt/testa-mcp"]
Instal Testa MCP di Gemini CLI
$ gemini mcp add -s user testa npx -- -y @valewnrt/testa-mcpInstal Testa MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Konfigurasi
TESTA_MCP_FULLSet to 1 to expose all 40 tools instead of the 13-tool token-lean default.
TESTA_UDIDTarget a specific simulator UDID instead of the booted one.
| Nama | Deskripsi | Tipe |
|---|---|---|
| TESTA_MCP_FULL | Set to 1 to expose all 40 tools instead of the 13-tool token-lean default. | |
| TESTA_UDID | Target a specific simulator UDID instead of the booted one. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauvalewnrt/testa is public and reachablegithub.com/valewnrt/testa ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@valewnrt/testa-mcp names valewnrt/testa as sourcenpmjs.com/package/@valewnrt/testa-mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-08github.com/valewnrt/testa ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @valewnrt/testa-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubTesta
Let your AI agent test your iOS app.
Testa gives Claude Code, Codex, Cursor or any MCP client eyes and hands in the
iOS Simulator. It reads the screen as compact text, taps, types and swipes with
real touch events, and checks the result. It works with React Native, Expo and
SwiftUI apps, and you don't have to add a single testID. When the agent is
done, save the run as a flow file and replay it in CI without a model.
Install
Requires macOS with Xcode 26 (iOS 26 simulators).
brew tap valewnrt/testa
brew install testa
testa setup # installs the Claude Code skill and registers the MCP server
Or build from source: git clone https://github.com/valewnrt/testa && cd testa && ./install.sh.
Connect your agent
testa setup already configures Claude Code. For other agents:
codex mcp add testa -- testa mcp # Codex
{ "mcpServers": { "testa": { "command": "testa", "args": ["mcp"] } } }
The JSON goes into Cursor's .cursor/mcp.json or any other MCP client config.
Then ask your agent something like "Launch the app in the simulator, sign up
with a test account and check that the welcome screen appears."
More in docs/agents.md.
Try it yourself
Testa is a plain CLI, so you can drive it by hand too:
$ testa boot "iPhone 17 Pro"
$ testa install ./MyApp.app && testa launch com.example.myapp
$ testa ui
19 elements (on screen)
e2 StaticText "ready" #status @201,89
e5 Button "Tap me" #tapButton @102,171
e18 TextField #textInput =type here @201,601
…
$ testa tap "Tap me"
tapped e5 Button Tap me
-- ui changes --
~ e2 StaticText "tap:1" #status @201,89
~ e6 StaticText "count: 1" #tapCount @41,208
$ testa assert "#status" label=tap:1
PASS label tap:1
The first command starts a background daemon (a few seconds, once). After that, each command takes about 60 ms.
What makes it different
- No app changes needed. Testa reads the accessibility tree and falls back to on-device OCR (Apple Vision) for anything that isn't in it: system sheets, canvas-drawn screens, games, WebViews. More →
- Built for token budgets. A screen is one line per element, about 200 tokens instead of about 1,500 for a screenshot, and every action replies with only what changed. Benchmark →
- Record once, replay in CI.
testa flow recordturns what the agent did into a plain-text flow file.testa flow runreplays it with JUnit output and failure artifacts, and there's a GitHub Action. More → - Real gestures and device control. Tap, long-press, swipe, drag-and-drop, pinch, rotate, multi-touch and hardware buttons, plus push notifications, location, Face ID, dark mode, Dynamic Type and more.
- One local binary, no dependencies. Testa talks to Apple's simulator frameworks directly: no Node, no Python, no WebDriver server. No network, no telemetry. How it works →
Status
Testa is pre-1.0 and is used against real production apps. It relies on private Apple frameworks, so a new Xcode can break it; a weekly job runs the suite against Xcode betas so breakage shows up early. Verified on Xcode 26.4 with iOS 26.4 simulators. iOS Simulator only: no real devices, no Android (why).
Documentation
- Commands: selectors, the observe → act → verify loop, full reference
- Using Testa from an AI agent: MCP setup, tools, token cost
- Testing apps without testIDs
- Flows & CI: flow files, recording, GitHub Action
- How it works · Security model
- How Testa compares to Maestro, Appium, idb and Argent
- Troubleshooting & limitations
Contributing
Bug reports, Xcode-compatibility reports and pull requests are welcome. Start with CONTRIBUTING.md; questions and ideas go to Discussions. Changes are listed in the CHANGELOG.
Acknowledgements
Testa's HID and accessibility work was informed by studying Meta's idb (MIT); no idb code is linked or bundled. Thanks to everyone who has contributed.
License
Pertanyaan tentang Testa MCP
Bagaimana cara menambahkan Testa MCP ke Claude Code?
Jalankan claude mcp add testa -- npx -y @valewnrt/testa-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Testa MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Aplikasi apa saja yang bisa diuji oleh Testa?
Testa bekerja dengan aplikasi React Native, Expo, dan SwiftUI tanpa memerlukan penambahan testID tambahan apa pun.
Apakah Testa memerlukan perubahan pada kode aplikasi saya?
Tidak, tool ini membaca accessibility tree dan menggunakan OCR on-device untuk elemen yang tidak ditemukan di dalam tree, seperti system sheets atau game.
Bisakah saya menjalankan pengujian ini di lingkungan CI?
Ya, Anda dapat merekam sesi agent sebagai flow file dan memutarnya kembali di CI menggunakan GitHub Action.
Apakah ini mendukung perangkat Android asli?
Tidak, Testa terbatas hanya untuk iOS Simulator dan tidak mendukung perangkat asli atau Android.