nnemirovsky/iwdp-mcp

**Debug iOS Safari from your AI agent.** No existing tool lets AI assistants interact with Safari on a real iPhone. Chrome DevTools MCP speaks CDP, which is incompatible with WebKit. This project bridges that gap.
100+ tools across all 27 WebKit Inspector Protocol domains — navigation, screenshots, DOM inspection, CSS, network interception, httpOnly cookies, JS debugging, heap snapshots, profiling, and more. Full feature parity between MCP server and CLI.
Why?
- **Chrome DevTools MCP** exists for desktop Chrome. **Nothing existed for iOS Safari** — until now.
- **httpOnly cookies** are invisible to document.cookie. This tool reads them via the protocol.
- **Real device testing** catches iOS-specific bugs that simulators miss.
- Works with **Claude Code, VS Code, Cursor, Windsurf, Codex CLI, Antigravity, JetBrains**, and any MCP-compatible client.
Installation
Prerequisites
For Linux and other platforms, see the ios-webkit-debug-proxy installation guide.
Claude Code Plugin (recommended)
Inside Claude Code, run:
Go Install
Pre-built Binaries
Download from GitHub Releases.
Build from Source
Quick Start
CLI
MCP Server
Claude Code
Install as a plugin (recommended):
Or add to your project's .mcp.json:
Or via CLI:
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
VS Code / VS Code Insiders
Click the install badges at the top of this README, or add to .vscode/mcp.json:
Or via CLI:
Cursor
Click the Cursor install badge at the top of this README, or add to .cursor/mcp.json:
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
Codex CLI
Or add to ~/.codex/config.toml:
Antigravity
Add to ~/.gemini/antigravity/mcp_config.json:
JetBrains IDEs
Go to **Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add**, or add the following JSON config:
Example Prompts
Once the MCP server is configured, you can ask your AI assistant things like:
**Getting started**
**JavaScript & DOM**
**CSS & Styles**
**Network**
**Storage & Cookies**
**Debugging**
**Performance & Profiling**
**Advanced**
How It Works
ios-webkit-debug-proxy exposes:
- **Port 9221** — lists all connected devices
- **Port 9222+** — each device gets an incremented port listing its Safari tabs
- Each tab provides a **WebSocket URL** for the WebKit Inspector Protocol
iwdp-mcp connects to those WebSocket endpoints and exposes 100+ tools.
Tools
Core
| Tool | Description |
|------|-------------|
| iwdp_status | Check/auto-start ios-webkit-debug-proxy |
| restart_iwdp | Restart iwdp after a crash (e.g., heap snapshot) |
| list_devices | List connected iOS devices (HTTP GET :9221) |
| list_pages | List Safari tabs (HTTP GET :9222+) |
| select_page | Connect to a specific tab |
| navigate | Go to URL |
| take_screenshot | Capture page as PNG |
| evaluate_script | Run JavaScript |
| get_document | Get DOM tree |
| query_selector | Find elements by CSS selector |
DOM & CSS
get_outer_html, get_attributes, get_event_listeners, highlight_node, get_matched_styles, get_computed_style, set_style_text, force_pseudo_state, and more.