Proxyman MCP

如需完整文件索引，請參閱 llms.txt。文件頁面的 Markdown 版本可透過在頁面網址後方加上 .md 取得；此頁面可於 Markdown 取得。

MCP

1. 什麼是 Proxyman MCP？

Proxyman MCP（模型上下文協定）是一項功能，讓 AI 助理（Claude、Cursor 及其他相容 MCP 的工具）能直接與 Proxyman macOS 應用程式互動。它允許 AI 透過自然語言對話來檢查 HTTP 流量、建立除錯規則及控制 Proxyman。

架構包含兩個元件：

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

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

✅ 提示範例

• 顯示最後 10 個對 api.example.com 的 API 請求
• 為所有對 /api/users 的 POST 請求建立中斷點
• 將失敗的請求匯出為 cURL 指令
• 為 *.stripe.com 啟用 SSL 代理
• 建立新的腳本來變更狀態碼、標頭、主體。
• 使用給定的網址建立 Map Local、中斷點工具

2. 優點

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

3. 如何新增 Proxyman MCP

1. 在 Proxyman 中啟用 MCP
   • 開啟 Proxyman → 設定 → MCP 分頁
   • 切換 啟用 MCP 伺服器以啟動 MCP 伺服器
2. 設定您的 MCP 客戶端（例如 Cursor、Claude Desktop）
3. 將 Proxyman MCP 新增至您的代理：

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 %}

手動

根據您的 AI 代理類型，您必須編輯代理設定以使用 Proxyman MCP。以下是設定檔 setting.json 的範例：

• 正式版本：

{
  "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 互動。

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	列出所有除錯規則（中斷點、map local、map remote、黑名單）
get_ssl_proxying_list	回傳 SSL 代理的包含/排除網域清單
get_certificate_status	回傳根憑證安裝狀態

寫入工具

工具	說明	必要參數
create_breakpoint	建立中斷點以暫停/檢查匹配的請求	url (模式)
create_map_local	為匹配的網址回傳自訂回應	url (模式)
create_map_remote	將請求從一個網址重新導向至另一個	from_url、to_url
create_blacklist	封鎖匹配網址模式的請求	url (模式)
enable_scripting_tool	建立腳本
enable_ssl_proxying	為網域啟用 HTTPS 解密	domain

工作階段控制

工具	說明
clear_session	清除目前工作階段中所有擷取的流程
toggle_recording	開始或停止流量錄製

流程操作

工具	說明
export_flow_curl	將擷取的請求匯出為可執行的 cURL 指令
filter_flows	使用多個條件（網址、主機、方法、狀態、標頭、主體）進行進階篩選，支援 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 金鑰）會在回應中自動遮蔽