# apple-log-mcp

Local MCP server for Apple platform console, unified, and diagnostic logs.

## Install

```bash
git clone https://github.com/BBC6BAE9/apple-log-mcp.git "$HOME/.local/share/apple-log-mcp"
cd "$HOME/.local/share/apple-log-mcp"
npm install
npm run build
```

## Codex config

Add this to `~/.codex/config.toml`.

```toml
[mcp_servers.apple_log]
command = "/bin/zsh"
args = ["-lc", "node \"$HOME/.local/share/apple-log-mcp/dist/index.js\""]
startup_timeout_sec = 30
```

Restart Codex after changing the config.

## Claude Desktop config

Add this to your MCP config JSON.

```json
{
  "mcpServers": {
    "apple_log": {
      "command": "/bin/zsh",
      "args": ["-lc", "node \"$HOME/.local/share/apple-log-mcp/dist/index.js\""]
    }
  }
}
```

## Tools

- `apple_list_devices`: list physical and simulated Apple devices.
- `apple_start_live_logs`: start a live capture session.
- `apple_read_live_logs`: read recent or incremental log lines.
- `apple_stop_live_logs`: stop a capture session.
- `apple_list_log_sessions`: list active sessions.

## Example

Start live logs for a simulator:

```json
{
  "target": "simulator",
  "device": "booted",
  "bundleId": "com.example.app",
  "streams": ["console", "unified"],
  "terminateExisting": true
}
```

Then read logs:

```json
{
  "sessionId": "<session id from apple_start_live_logs>",
  "limit": 200
}
```

## Notes

- Swift `print()` is stdout. To capture it reliably, start the app through this MCP.
- Objective-C `NSLog`, `os_log`, and Swift `Logger` usually go through Apple unified logging.
- The MCP does not expose a raw shell. It wraps `xcrun devicectl`, `xcrun simctl`, and `log`.