English | 日本語

---

SnapDrive

Snapshot testing tool for iOS. Leverages AI Agents to autonomously operate iOS Simulator, automatically generating test scenarios and baselines. Adapts flexibly to UI changes, preventing test case decay.

Requirements

- macOS + Xcode
- Node.js 20+
- Python 3.x + fb-idb

Setup

$3

``bash
pip install fb-idb
`

$3

Add to .mcp.json:

`json
{
"mcpServers": {
"snapdrive": {
"command": "npx",
"args": ["snapdrive-ios"]
}
}
}
`

With environment variables:

`json
{
"mcpServers": {
"snapdrive": {
"command": "npx",
"args": ["snapdrive-ios"],
"env": {
"SNAPDRIVE_RESULTS_DIR": "/path/to/your/project/results",
"SNAPDRIVE_LOG_LEVEL": "debug"
}
}
}
}
`

$3

| Variable | Description | Default |
|----------|-------------|---------|
| SNAPDRIVE_RESULTS_DIR | Results output directory | ./results |
| SNAPDRIVE_LOG_LEVEL | Log level (debug/info/warn/error) | info |

Version Control

The .snapdrive directory should be committed to Git:

`bash
git add .snapdrive/
git commit -m "Add SnapDrive test cases and baselines"
`

This allows your team to share test scenarios and baselines, ensuring consistent visual regression testing across all environments.

> Note: The results/ directory contains test execution outputs and should be added to .gitignore`.

Documentation

- Usage Guide - Basic operations
- Test Cases - Creating and running structured tests
- CLI - Command-line tool usage
- Fastlane Integration - CI/CD with Fastlane
- MCP Tools Reference - Available tools reference

License

MIT