# xpresso

Xcode MCP server. Build, test, run, and manage simulators directly from Claude Code — no Xcode GUI needed.

## Quick Start

```bash
claude mcp add xpresso -- npx xpresso-mcp
```

That's it. Restart Claude Code and you're ready.

## Requirements

- Node.js >= 18 (or Bun)
- Xcode with command line tools (`xcode-select --install`)

## Tools

| Tool | Description |
|------|-------------|
| `xpresso_build` | Build project/workspace with scheme |
| `xpresso_test` | Run unit/UI tests |
| `xpresso_run` | Build, install, and launch on simulator |
| `xpresso_clean` | Clean build folder |
| `xpresso_schemes` | List schemes, targets, configurations |
| `xpresso_build_settings` | Show resolved build settings |
| `xpresso_simulators` | List available simulators |
| `xpresso_boot_simulator` | Boot a simulator |
| `xpresso_shutdown_simulator` | Shutdown a simulator |
| `xpresso_devices` | List connected physical devices |
| `xpresso_logs` | Get output from last operation |

## Examples

Build a project:
```
xpresso_build(scheme: "MyApp", workspace: "MyApp.xcworkspace")
```

Run tests:
```
xpresso_test(scheme: "MyApp", workspace: "MyApp.xcworkspace", destination: "platform=iOS Simulator,name=iPhone 16")
```

Boot simulator and run:
```
xpresso_boot_simulator(simulator: "iPhone 16")
xpresso_run(scheme: "MyApp", workspace: "MyApp.xcworkspace", simulator: "<UDID>")
```

## Development

```bash
git clone https://github.com/alisheryeginbay/xpresso.git
cd xpresso
bun install
bun run src/index.ts
```

## License

MIT