用途
iwdp-mcp 用于从 AI 智能体调试 iOS Safari。项目说明指出,此前没有工具能让 AI 助手与真实 iPhone 上的 Safari 交互;Chrome DevTools MCP 使用 CDP 协议,与 WebKit 不兼容。本项目通过 ios-webkit-debug-proxy 桥接这一缺口,使 AI 助手能够连接真实 iOS 设备上的 Safari 进行调试。
主要能力
项目提供 100 多个工具,覆盖全部 27 个 WebKit Inspector Protocol 域,MCP 服务器与 CLI 功能完全对等。具体包括:
- 导航与截图
- DOM 检查:get_outer_html、get_attributes、get_event_listeners、highlight_node 等
- CSS:get_matched_styles、get_computed_style、set_style_text、force_pseudo_state 等
- 网络拦截:network_enable、list_network_requests、get_response_body、set_request_interception、intercept_continue、intercept_with_response、set_emulated_conditions、set_resource_caching_disabled
- 存储与 Cookie:get_cookies(支持 httpOnly 与 secure)、set_cookie、delete_cookie、get_local_storage、get_session_storage、list_indexed_databases、get_indexed_db_data
- JavaScript 调试:debugger_enable、set_breakpoint、pause、resume、step_over、step_into、step_out、get_script_source、evaluate_on_call_frame、set_pause_on_exceptions
- 性能与剖析:timeline_start/stop、memory_start/stop_tracking、heap_snapshot、cpu_start/stop_profiling、script_start/stop_profiling
- 其他:Animation、Canvas、LayerTree、Workers、Audit、Security(TLS 证书)以及元素交互(click、fill、type_text)
项目特别指出,httpOnly Cookie 对 document.cookie 不可见,本工具可通过协议读取它们;真实设备测试能发现模拟器遗漏的 iOS 特有缺陷。
使用方式
项目提供多种安装与配置途径:
- Claude Code 插件(推荐):在 Claude Code 内运行安装命令
- 预编译二进制:从 GitHub Releases 下载
- 从源码构建
- 作为插件安装(推荐)
- 添加到项目的 .mcp.json
- 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json
- 通过 README 顶部的安装徽章,或添加到 .vscode/mcp.json
- 通过 Cursor 安装徽章,或添加到 .cursor/mcp.json
- 添加到 ~/.codeium/windsurf/mcp_config.json
- 添加到 ~/.codex/config.toml
- 添加到 ~/.gemini/antigravity/mcp_config.json
- JetBrains:Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add,或添加对应 JSON 配置
对于 Linux 及其他平台,项目指向 ios-webkit-debug-proxy 安装指南。
工作原理:ios-webkit-debug-proxy 暴露端口 9221(列出所有已连接设备)和端口 9222+(每台设备递增端口,列出其 Safari 标签页);每个标签页提供 WebKit Inspector Protocol 的 WebSocket URL。iwdp-mcp 连接这些 WebSocket 端点并暴露 100 多个工具。
适用场景
- 使用 AI 助手调试真实 iPhone 上的 iOS Safari
- 检查 DOM、CSS、网络请求、存储与 Cookie(含 httpOnly)
- 进行 JavaScript 断点调试、堆快照与性能剖析
- 在真实设备上发现模拟器遗漏的 iOS 特有缺陷
- 与 Claude Code、VS Code、Cursor、Windsurf、Codex CLI、Antigravity、JetBrains 等 MCP 兼容客户端配合使用
限制
- 依赖 ios-webkit-debug-proxy,需另行安装
- E2E 测试需要 macOS 与 Xcode,并安装 ios-webkit-debug-proxy;GitHub Actions macos-latest 运行器已预装 Xcode 与 iOS Simulator 运行时
- 单元测试使用模拟 WebKit Inspector Protocol 的 mock WebSocket 服务器(internal/webkit/testutil/)
- 项目采用 MIT 许可;ios-webkit-debug-proxy 为独立项目,采用 BSD-3-Clause 许可,本工具在运行时通过 HTTP/WebSocket 连接它,不捆绑其代码
其他具体功能、收费、价格、平台或效果信息暂未提供。