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（Model Context Protocol）是一項功能，可讓 AI 助理（Codex、Claude Code、Cursor 及其他相容 MCP 的工具）直接與 Proxyman macOS 應用程式互動。它允許 AI 透過自然語言對話來檢查 HTTP 流量、建立除錯規則，以及控制 Proxyman。

其架構包含兩個元件：

• MCP HTTP Server - 在 Proxyman 應用程式內部的 localhost 上執行，並採用基於 token 的驗證
• MCP CLI Server - 一個基於 stdio 的 MCP 伺服器，AI 工具會連線至此，並將指令轉發至 Proxyman

{% hint style="info" %} 請查看適用於您 AI Agent 的 Proxyman SKILL.md {% endhint %}

✅ 範例提示詞

• 顯示最近 10 筆傳送至 api.example.com 的 API 要求
• 為所有傳送至 /api/users 的 POST 要求建立中斷點
• 將失敗的要求匯出為 cURL 指令
• 為 *.stripe.com 啟用 SSL 代理
• 建立新的 Script 以變更狀態碼、標頭、內文
• 使用指定的 URL 建立 Map Local、Breakpoint 工具

2. 優點

優點	說明
AI 驅動除錯	讓 AI 分析已擷取的流量、尋找特定要求，或解釋 API 回應
免動手建立規則	透過對話建立中斷點、map local/remote 規則
更快速的工作流程	匯出 cURL 指令、篩選 flows，以及管理 session，無需切換上下文
安全設計	僅限 localhost 的伺服器，並採用每個 session 的 token 驗證
IDE 整合	與 Cursor 及其他相容 MCP 的工具無縫搭配

3. 如何新增 Proxyman MCP

1. 在 Proxyman 中啟用 MCP
   • 開啟 Proxyman → Settings → MCP 分頁
   • 切換 Enable MCP Server 以啟動 MCP Server
2. 選擇您的 MCP 用戶端： 在 Proxyman Settings → MCP 中，選擇 Codex 或 Claude Code，然後使用 Copy Command。若使用 Cursor，請選擇 Manual，並將顯示的設定新增至 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 %}

Manual

若使用 Cursor 或其他 MCP 用戶端，請將 Proxyman Manual 分頁中的設定新增至用戶端的 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 是否已啟用、設定的應用程式路徑是否正確，然後重新連線用戶端。如果連線成功但找不到任何 flows，請發出新的要求，並參考 missing-traffic 檢查清單。

4. 可用工具

唯讀工具

工具	說明
get_version	回傳 Proxyman 版本與建置編號
get_proxy_status	回傳錄製狀態、代理連接埠，以及 SSL 代理狀態
get_flows	列出已擷取的 HTTP/HTTPS flows，並可搭配選用篩選條件（limit、host_filter、method_filter、status_filter）
get_flow_detail	回傳特定 flow 的完整詳細資料，包括標頭、內文預覽、查詢參數與 cookies
list_rules	列出所有除錯規則（breakpoints、map local、map remote、blacklist）
get_ssl_proxying_list	回傳 SSL 代理的包含/排除網域清單
get_certificate_status	回傳根憑證安裝狀態

寫入工具

工具	說明	必要參數
create_breakpoint	建立中斷點以暫停/檢查符合條件的要求	url (pattern)
create_map_local	為符合條件的 URL 回傳自訂回應	url (pattern)
create_map_remote	將要求從一個 URL 重新導向至另一個	from_url、to_url
create_blacklist	封鎖符合 URL pattern 的要求	url (pattern)
enable_scripting_tool	建立 Script
enable_ssl_proxying	為某個網域啟用 HTTPS 解密	domain

Session 控制

工具	說明
clear_session	清除目前 session 中所有已擷取的 flows
toggle_recording	開始或停止流量錄製

Flow 操作

工具	說明
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	列出所有作用中的除錯規則（中斷點、Map Local、Map Remote、黑名單、腳本、DNS 偽造、網路條件、白名單）
get_ssl_proxying_list	取得目前的 SSL 代理設定，包括啟用狀態與網域清單
create_breakpoint	建立新的中斷點規則，以暫停並檢查/修改符合 URL 模式的請求或回應
create_map_local	建立 Map Local 規則，為符合的請求傳回自訂回應
create_map_remote	建立 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	切換 No Caching 功能（移除與快取相關的標頭）
inject_electron	啟動已注入 Proxyman 代理設定的 Electron 應用程式
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 金鑰）會在回應中自動遮罩