AIエージェントがiOS Simulatorと対話することを可能にし、画面の読み取り、タッチジェスチャの実行、およびCIでのテストフローの再生を実現します。
別名 valewnrt/testa, @valewnrt/testa-mcp
- スター
- 3
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.2.2
- 最終コミット
- 2026年10月8日
- ライセンス
- MIT
Testa MCPとは
TestaはMCPサーバーです。 AIエージェントがiOS Simulatorと対話することを可能にし、画面の読み取り、タッチジェスチャの実行、およびCIでのテストフローの再生を実現します。.
プロジェクトのREADMEから生成された概要
Testa MCP server について
Testaは、macOS上のiOS Simulatorと直接対話する機能をAIエージェントに提供します。これはMCP serverとして機能し、Claude Code、Cursor、Codexなどのクライアントに対して、モバイルインターフェースの閲覧および操作能力を付与します。このツールは、アクセシビリティツリーを読み取り、Apple Vision OCRを使用して画面を解釈することで動作するため、コードの変更や特定のテスト識別子(testID)を必要とせずに、React Native、Expo、またはSwiftUIアプリケーションを操作できます。
ユーザーは、Xcodeが動作しているMac上でHomebrewを使用してサーバーをインストールします。設定完了後、エージェントはタップ、タイピング、スワイプ、デバイスの回転などの複雑なタスクを実行できます。このシステムは、画面を重い画像ではなくコンパクトなテキストとして表現することで、LLMのトークン予算を効率的に使用するように設計されています。また、開発者はエージェントの操作をフローファイルに記録し、GitHub Actionを使用してCI環境で再生することも可能です。これにより、実行中にライブモデルを必要とすることなく、JUnit形式の出力や失敗時のアーティファクトを取得できます。
できること
- 1UIテストの自動化エージェントにアプリケーションを起動させ、特定のユーザー登録フローを完了させるよう指示します。
- 2コード修正なしのテスト定義済みのテスト識別子が設定されていない画面上で、アプリの動作を検証します。
- 3継続的インテグレーション(CI)での再生以前に記録したエージェントのインタラクションをCIパイプラインで実行し、安定性を確保します。
- 4複雑なジェスチャのシミュレーションピンチ操作や要素のドラッグなどのマルチタッチ操作をAIに指示します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Testa MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにTesta MCPをインストール
$ claude mcp add testa -- npx -y @valewnrt/testa-mcpCursorにTesta MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}VS CodeにTesta MCPをインストール
.vscode/mcp.json
{
"servers": {
"testa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}VS Code CLIにTesta MCPをインストール
$ code --add-mcp '{"name":"testa","type":"stdio","command":"npx","args":["-y","@valewnrt/testa-mcp"]}'Claude DesktopにTesta MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}CodexにTesta MCPをインストール
$ codex mcp add testa -- npx -y @valewnrt/testa-mcpCodex config.tomlにTesta MCPをインストール
~/.codex/config.toml
[mcp_servers.testa] command = "npx" args = ["-y", "@valewnrt/testa-mcp"]
Gemini CLIにTesta MCPをインストール
$ gemini mcp add -s user testa npx -- -y @valewnrt/testa-mcpGemini settings.jsonにTesta MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"testa": {
"command": "npx",
"args": [
"-y",
"@valewnrt/testa-mcp"
]
}
}
}設定
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.
| 名前 | 説明 | 種類 |
|---|---|---|
| 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. |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能valewnrt/testa is public and reachablegithub.com/valewnrt/testa ↗合格
- パッケージがこのリポジトリをソースとして指定@valewnrt/testa-mcp names valewnrt/testa as sourcenpmjs.com/package/@valewnrt/testa-mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-08github.com/valewnrt/testa ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @valewnrt/testa-mcp合格
- パッケージおよびその依存関係に重大な勧告なし1 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るTesta
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
Testa MCPのよくある質問
Testa MCPをClaude Codeに追加するには
ターミナルでclaude mcp add testa -- npx -y @valewnrt/testa-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Testa MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Testaはどのようなアプリをテストできますか?
React Native、Expo、SwiftUIのアプリに対応しており、追加のtestIDの設定は不要です。
Testaを使用するためにアプリケーションのコードを変更する必要がありますか?
いいえ。アクセシビリティツリーを読み取り、システムシートやゲームなどツリー内に見つからない要素についてはデバイス上のOCRを使用して処理します。
CI環境でこれらのテストを実行できますか?
はい。エージェントのセッションをフローファイルとして記録し、GitHub Actionを使用してCIで再生できます。
実機のAndroidデバイスはサポートしていますか?
いいえ。TestaはiOS Simulatorのみに対応しており、実機やAndroidはサポートしていません。