Permite que los agentes de IA interactúen con el iOS Simulator leyendo la pantalla, realizando gestos táctiles y reproduciendo flujos de prueba en CI.
También conocido como valewnrt/testa, @valewnrt/testa-mcp
- Stars
- 3
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.2.2
- Último commit
- 8 oct 2026
- Licencia
- MIT
¿Qué es Testa MCP?
Testa es un MCP server. Permite que los agentes de IA interactúen con el iOS Simulator leyendo la pantalla, realizando gestos táctiles y reproduciendo flujos de prueba en CI.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Testa
Testa proporciona a los agentes de IA la capacidad de interactuar directamente con el iOS Simulator en macOS. Funciona como un MCP server que otorga a clientes como Claude Code, Cursor o Codex la capacidad de ver y manipular interfaces móviles. La herramienta funciona leyendo el árbol de accesibilidad y utilizando el OCR de Apple Vision para interpretar las pantallas, lo que le permite operar en aplicaciones de React Native, Expo o SwiftUI sin necesidad de realizar cambios en el código ni utilizar identificadores de prueba específicos.
Los usuarios instalan el servidor vía Homebrew en un Mac que ejecute Xcode. Una vez configurado, un agente puede realizar tareas complejas como tocar, escribir, deslizar o rotar el dispositivo. El sistema está diseñado para ser eficiente con el presupuesto de tokens de los LLM al representar las pantallas como texto compacto en lugar de imágenes pesadas. Los desarrolladores también pueden grabar las acciones del agente en archivos de flujo para reproducirlas en entornos de CI mediante una GitHub Action, la cual proporciona salida JUnit y artefactos de error sin necesidad de un modelo en vivo durante la ejecución.
Qué puedes hacer con él
- 1Pruebas de UI automatizadasPide a un agente que inicie una aplicación y complete un flujo específico de registro de usuario.
- 2Pruebas sin modificaciones de códigoVerifica el comportamiento de la aplicación en pantallas que no tienen identificadores de prueba predefinidos.
- 3Reproducción en Integración ContinuaEjecuta interacciones de agentes grabadas previamente en un pipeline de CI para garantizar la estabilidad.
- 4Simulación de gestos complejosInstruye a una IA para que realice interacciones multitáctiles como pellizcar o arrastrar elementos.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Testa MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Testa MCP en Claude Code
$ claude mcp add testa -- npx -y @valewnrt/testa-mcpInstalar Testa MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Instalar Testa MCP en VS Code
.vscode/mcp.json
{
"servers": {
"testa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Instalar Testa MCP en VS Code CLI
$ code --add-mcp '{"name":"testa","type":"stdio","command":"npx","args":["-y","@valewnrt/testa-mcp"]}'Instalar Testa MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Instalar Testa MCP en Codex
$ codex mcp add testa -- npx -y @valewnrt/testa-mcpInstalar Testa MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.testa] command = "npx" args = ["-y", "@valewnrt/testa-mcp"]
Instalar Testa MCP en Gemini CLI
$ gemini mcp add -s user testa npx -- -y @valewnrt/testa-mcpInstalar Testa MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}Configuración
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.
| Nombre | Descripción | Tipo |
|---|---|---|
| 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. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblevalewnrt/testa is public and reachablegithub.com/valewnrt/testa ↗Aprobado
- El paquete indica este repositorio como su origen@valewnrt/testa-mcp names valewnrt/testa as sourcenpmjs.com/package/@valewnrt/testa-mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-08github.com/valewnrt/testa ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @valewnrt/testa-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre Testa MCP
¿Cómo agrego Testa MCP a Claude Code?
Ejecuta claude mcp add testa -- npx -y @valewnrt/testa-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Testa MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué aplicaciones puede probar Testa?
Funciona con aplicaciones de React Native, Expo y SwiftUI sin necesidad de añadir testID adicionales.
¿Requiere Testa cambios en el código de mi aplicación?
No, lee el árbol de accesibilidad y utiliza OCR en el dispositivo para los elementos que no se encuentran en el árbol, como hojas del sistema o juegos.
¿Puedo ejecutar estas pruebas en un entorno de CI?
Sí, puedes grabar la sesión de un agente como un archivo de flujo y reproducirla en CI mediante una GitHub Action.
¿Es compatible con dispositivos Android reales?
No, Testa se limita únicamente al iOS Simulator y no es compatible con dispositivos reales ni con Android.