SuperAPI AI 工具集

iwdp-mcp

iwdp-mcp 是一个面向 iOS Safari 调试的 MCP 服务器与 CLI 工具,通过 ios-webkit-debug-proxy 连接真实 iPhone 上的 Safari,并完整支持 WebKit Inspector Protocol。它提供 100 多个工具,覆盖全部 27 个 WebKit Inspector Protocol 域,包括导航、截图、DOM 检查、CSS、网络拦截、httpOnly Cookie 读取、JavaScript 调试、堆快照和性能分析等。该工具填补了 AI 助手无法与真实 iOS Safari 交互的空白,可与 Claude Code、VS Code、Cursor、Windsurf、Codex CLI、Antigravity、JetBrains 等任何兼容 MCP 的客户端配合使用。

访问官网

工具介绍

用途

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 连接它,不捆绑其代码

其他具体功能、收费、价格、平台或效果信息暂未提供。