Proxyman MCP

如需查看完整的文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面 URL 后附加 .md 获取；本页面也可作为 Markdown 查看。

MCP

将 Codex、Claude Code 或 Cursor 连接到 Proxyman MCP，即可从你的 AI 助手中检查捕获的 HTTP/HTTPS 流量并创建调试规则。

Proxyman MCP 可将你的 AI 助手连接到运行在电脑上的 Proxyman macOS 应用。你可以用它来检查捕获的请求和响应、调查故障并创建调试规则。在让助手分析之前，请保持 Proxyman 打开并捕获你想要调查的流量。

1. 什么是 Proxyman MCP？

Proxyman MCP（模型上下文协议）是一项功能，使 AI 助手（Codex、Claude Code、Cursor 及其他兼容 MCP 的工具）能够直接与 Proxyman macOS 应用交互。它允许 AI 通过自然语言对话来检查 HTTP 流量、创建调试规则并控制 Proxyman。

该架构由两个组件组成：

• MCP HTTP 服务器 - 在 Proxyman 应用内运行于 localhost，并采用基于令牌的身份验证
• MCP CLI 服务器 - 一个基于 stdio 的 MCP 服务器，AI 工具连接后，它会将命令转发给 Proxyman

{% hint style="info" %} 查看适用于你的 AI 代理的 Proxyman SKILL.md {% endhint %}

✅ 示例提示

• 显示最近 10 个发送到 api.example.com 的 API 请求
• 为所有发送到 /api/users 的 POST 请求创建一个断点
• 将失败的请求导出为 cURL 命令
• 为 *.stripe.com 启用 SSL 代理
• 创建一个新脚本以更改状态码、请求头、响应体
• 使用给定的 URL 创建 Map Local、Breakpoint 工具

2. 优势

优势	描述
AI 驱动的调试	让 AI 分析捕获的流量、查找特定请求或解释 API 响应
免手动创建规则	通过对话创建断点、映射本地/远程规则
更高效的工作流程	无需切换上下文即可导出 cURL 命令、筛选流量和管理会话
安全设计	仅限 localhost 的服务器，并采用每会话令牌身份验证
IDE 集成	与 Cursor 及其他兼容 MCP 的工具无缝协作

3. 如何添加 Proxyman MCP

1. 在 Proxyman 中启用 MCP
   • 打开 Proxyman → 设置 → MCP 标签页
   • 切换 启用 MCP 服务器以启动 MCP 服务器
2. 选择你的 MCP 客户端： 在 Proxyman 设置 → MCP 中，选择 Codex 或 Claude Code，然后使用 复制命令。对于 Cursor，请选择 手动，并将显示的配置添加到 Cursor 的 MCP 设置中。
3. 根据你的客户端和安装方式使用下面的设置。Proxyman 生成的命令使用你已安装应用的路径，可能与这些示例不同。在正常调试时，请保持敏感数据脱敏功能开启。

Codex

• 正式版：

codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

• Setapp 版：

codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

• 正式版：

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

• Setapp 版：

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

手动

对于 Cursor 和其他 MCP 客户端，请将 Proxyman 手动 标签页中的配置添加到客户端的 MCP 设置中。请选择与你已安装的 Proxyman 应用对应的配置。以下示例展示了 mcpServers 条目：

• 正式版：

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

• Setapp 版：

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

4. 开始使用 Proxyman MCP

• 确保 Proxyman 正在运行
• 让你的 AI 助手与 Proxyman 交互，例如：“显示最近发送到 api.example.com 的请求。”
• 如果客户端找不到 Proxyman，请检查 MCP 是否已启用且配置的应用路径是否正确，然后重新连接客户端。如果连接成功但找不到任何流量，请发起一个新请求，并使用 流量缺失检查清单。

4. 可用工具

只读工具

工具	描述
get_version	返回 Proxyman 版本和构建号
get_proxy_status	返回录制状态、代理端口和 SSL 代理状态
get_flows	列出捕获的 HTTP/HTTPS 流量，支持可选筛选条件（limit、host_filter、method_filter、status_filter）
get_flow_detail	返回特定流量的完整详情，包括请求头、响应体预览、查询参数和 Cookie
list_rules	列出所有调试规则（断点、映射本地、映射远程、黑名单）
get_ssl_proxying_list	返回 SSL 代理的包含/排除域名列表
get_certificate_status	返回根证书安装状态

写入工具

工具	描述	必需参数
create_breakpoint	创建断点以暂停/检查匹配的请求	url（模式）
create_map_local	为匹配的 URL 返回自定义响应	url（模式）
create_map_remote	将请求从一个 URL 重定向到另一个	from_url、to_url
create_blacklist	阻止匹配 URL 模式的请求	url（模式）
enable_scripting_tool	创建脚本
enable_ssl_proxying	为某个域名启用 HTTPS 解密	domain

会话控制

工具	描述
clear_session	清除当前会话中所有捕获的流量
toggle_recording	开始或停止流量录制

流量操作

工具	描述
export_flow_curl	将捕获的请求导出为可运行的 cURL 命令
filter_flows	使用多个条件（url、host、method、status、headers、body）进行高级筛选，支持 AND/OR 组合

应用控制

工具	描述
open_proxyman	如果 Proxyman 未运行，则启动它
quit_proxyman	退出 Proxyman 应用

---

更新日志

MCP v3（Proxyman macOS ≥ 6.8.0）

名称	描述
get_version	获取当前 Proxyman macOS 应用的版本号和构建号
get_proxy_status	获取当前代理状态，包括录制状态、端口号和 SSL 代理状态
get_flows	从 Proxyman 的活动会话数据源获取最近的 HTTP/HTTPS 流
get_flow_detail	获取特定流的详细信息，包括请求头、请求体、查询参数和 Cookie
list_rules	列出所有活动的调试规则（断点、映射本地、映射远程、黑名单、脚本、DNS 欺骗、网络条件、白名单）
get_ssl_proxying_list	获取当前的 SSL 代理配置，包括启用状态和域名列表
create_breakpoint	创建新的断点规则，以暂停并检查/修改匹配 URL 模式的请求或响应
create_map_local	创建映射本地规则，为匹配的请求返回自定义响应
create_map_remote	创建映射远程规则，将请求从一个 URL 重定向到另一个 URL
create_blacklist	创建黑名单规则，以阻止匹配 URL 模式的请求
create_scripting_rule	创建脚本规则，使用自定义 JavaScript 修改请求/响应
enable_ssl_proxying	为特定域名启用 SSL 代理，以解密 HTTPS 流量
clear_session	清除当前会话中的所有捕获流
toggle_recording	开始或停止录制 HTTP 流量
export_flow_curl	将捕获的 HTTP 请求导出为 cURL 命令
filter_flows	使用高级过滤条件过滤捕获的 HTTP/HTTPS 流
get_certificate_status	获取 Proxyman 根证书的当前状态
install_certificate	安装并信任 Proxyman 根 CA 证书
uninstall_certificate	从钥匙串中移除 Proxyman 根 CA 证书
inject_terminal	启动一个终端应用，并注入 Proxyman 代理环境变量
get_terminal_manual_command	获取用于手动设置代理环境变量的 bash source 命令
answer_setup_question	回答关于从 iOS、Android、浏览器等捕获 HTTPS 的设置问题
search_docs	搜索内置的 Proxyman 设置和故障排除文档索引
list_setup_workflows	列出 Proxyman MCP 可以引导用户完成的受支持的设置工作流
list_popular_workflows	使用 Proxyman 精选的回退排名列出热门设置工作流
open_proxyman_screen	在 macOS 应用中打开特定的 Proxyman 指南或设置界面
run_guided_setup	在 Proxyman 中为浏览器或 Android 模拟器运行一键自动化
list_reverse_proxies	列出已配置的反向代理条目
create_reverse_proxy	为 localhost 或自定义本地端口路由创建反向代理条目
generate_code	从捕获的 HTTP 流中以 18 种以上语言/框架生成代码
create_dns_spoofing	创建 DNS 欺骗规则，将主机名重定向到不同的 IP 地址
list_dns_spoofing	列出所有 DNS 欺骗规则及其启用状态
update_dns_spoofing	更新现有的 DNS 欺骗规则
get_external_proxy	获取当前外部代理（上游代理）配置
set_external_proxy	为特定协议类型配置外部代理设置
toggle_no_caching	切换“无缓存”功能（移除与缓存相关的请求头）
inject_electron	启动一个 Electron 应用，并注入 Proxyman 代理配置
open_proxyman	启动 Proxyman macOS 应用
quit_proxyman	退出 Proxyman macOS 应用

MCP v2（Proxyman ≥ v6.7.0）

• 内置知识库，涵盖 iOS、Android、浏览器、终端、VPN、localhost 和第三方库
• 新命令：answer_setup_question、search_docs、list_setup_workflows、open_proxyman_screen、run_guided_setup、create_reverse_proxy
• 面向聊天客户端的 MCP 资源和提示模板
• 反向代理的创建/列表支持

安全性

• 服务器仅绑定到 127.0.0.1（不暴露网络）
• 每会话加密令牌存储在 ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json 中
• 握手文件的权限为 0600（仅所有者可访问）
• 敏感数据（认证令牌、密码、API 密钥）会在响应中自动脱敏