Proxyman MCP

ทางการ

Proxyman MCP ช่วยให้ AI สามารถตรวจสอบการรับส่งข้อมูล HTTP สร้างกฎการดีบัก และควบคุม Proxyman ได้ผ่านการสนทนาด้วยภาษาธรรมชาติ

ดูบน proxyman.com

คุณทำอะไรได้บ้างด้วย Proxyman MCP?

Inspect captured traffic — ขอให้ AI แสดงรายการ HTTP flows ล่าสุดด้วย get_flows และเจาะลึกไปยังรายละเอียดคำขอ/การตอบสนองแบบเต็มด้วย get_flow_detail
Create debugging rules via conversation — ตั้งค่า breakpoints, map local, map remote หรือกฎ blacklist โดยใช้ create_breakpoint, create_map_local, create_map_remote และ create_blacklist
Control the proxy session — เริ่มหรือหยุดการบันทึกด้วย toggle_recording และล้าง flows ที่บันทึกไว้ทั้งหมดด้วย clear_session
Export requests as code — ส่งออก flow ที่บันทึกเป็นคำสั่ง cURL ด้วย export_flow_curl หรือสร้างโค้ดไคลเอ็นต์ใน 18+ ภาษาโดยใช้ generate_code
Manage SSL decryption — เปิดใช้งานการถอดรหัส HTTPS สำหรับโดเมนด้วย enable_ssl_proxying และตรวจสอบสถานะการติดตั้งใบรับรองผ่าน get_certificate_status
Configure advanced proxy settings — ตั้งค่า proxy ภายนอกต้นทางด้วย set_external_proxy, สร้างรายการ reverse proxy ด้วย create_reverse_proxy หรือสลับพฤติกรรมไม่แคช

เอกสาร

สำหรับดัชนีเอกสารฉบับสมบูรณ์ ดูที่ llms.txt เวอร์ชัน Markdown ของหน้าเอกสารมีให้ใช้งานโดยการเพิ่ม .md ต่อท้าย URL ของหน้า หน้านี้มีให้ใช้งานในรูปแบบ Markdown

MCP

1. Proxyman MCP คืออะไร?

Proxyman MCP (Model Context Protocol) เป็นฟีเจอร์ที่ช่วยให้ผู้ช่วย AI (Claude, Cursor และเครื่องมืออื่นๆ ที่เข้ากันได้กับ MCP) สามารถโต้ตอบกับแอป Proxyman บน macOS ได้โดยตรง ช่วยให้ AI สามารถตรวจสอบทราฟฟิก HTTP, สร้างกฎการดีบัก และควบคุม Proxyman ได้ ทั้งหมดนี้ผ่านการสนทนาด้วยภาษาธรรมชาติ

สถาปัตยกรรมประกอบด้วยสององค์ประกอบ:

MCP HTTP Server - ทำงานภายในแอป Proxyman บน localhost พร้อมการยืนยันตัวตนแบบใช้โทเค็น
MCP CLI Server - เซิร์ฟเวอร์ MCP แบบ stdio ที่เครื่องมือ AI เชื่อมต่อด้วย ซึ่งจะส่งต่อคำสั่งไปยัง Proxyman

{% hint style="info" %} ลองดู Proxyman SKILL.md สำหรับ AI Agents ของคุณ {% endhint %}

✅ ตัวอย่างพร้อมท์

แสดงคำขอ API 10 รายการล่าสุดไปยัง api.example.com
สร้างเบรกพอยต์สำหรับคำขอ POST ทั้งหมดไปยัง /api/users
ส่งออกคำขอที่ล้มเหลวเป็นคำสั่ง cURL
เปิดใช้งาน SSL proxying สำหรับ *.stripe.com
สร้าง Script ใหม่เพื่อเปลี่ยนรหัสสถานะ, ส่วนหัว, เนื้อหา
สร้างเครื่องมือ Map Local, Breakpoint ด้วย URL ที่กำหนด

2. ประโยชน์

ประโยชน์	คำอธิบาย
การดีบักด้วย AI	ขอให้ AI วิเคราะห์ทราฟฟิกที่จับได้, ค้นหาคำขอที่เฉพาะเจาะจง, หรืออธิบายการตอบสนองของ API
การสร้างกฎแบบไม่ต้องใช้มือ	สร้างเบรกพอยต์, กฎ map local/remote ผ่านการสนทนา
เวิร์กโฟลว์ที่รวดเร็วขึ้น	ส่งออกคำสั่ง cURL, กรองโฟลว์, และจัดการเซสชันโดยไม่ต้องสลับบริบท
ปลอดภัยโดยการออกแบบ	เซิร์ฟเวอร์เฉพาะ localhost พร้อมการยืนยันตัวตนด้วยโทเค็นต่อเซสชัน
การผสานรวมกับ IDE	ทำงานร่วมกับ Cursor และเครื่องมืออื่นๆ ที่เข้ากันได้กับ MCP ได้อย่างราบรื่น

3. วิธีเพิ่ม Proxyman MCP

เปิดใช้งาน MCP ใน Proxyman
- เปิด Proxyman → การตั้งค่า → แท็บ MCP
- สลับ เปิดใช้งาน MCP Server เพื่อเริ่ม MCP Server
กำหนดค่า MCP client ของคุณ (เช่น Cursor, Claude Desktop)
เพิ่ม Proxyman MCP ไปยัง Agents ของคุณ:

Codex

เวอร์ชัน Production:

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

เวอร์ชัน Production:

{% 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 Agents ของคุณคืออะไร คุณต้องแก้ไขการตั้งค่า Agent เพื่อใช้ Proxyman MCP นี่คือตัวอย่าง setting.json:

เวอร์ชัน Production:

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

เวอร์ชัน Setapp

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

เริ่มใช้ Proxyman MCP

ตรวจสอบให้แน่ใจว่า Proxyman กำลังทำงานอยู่
ขอให้ผู้ช่วย AI ของคุณโต้ตอบกับ Proxyman

4. เครื่องมือที่พร้อมใช้งาน

เครื่องมืออ่านอย่างเดียว

เครื่องมือ	คำอธิบาย
`get_version`	ส่งคืนเวอร์ชันและหมายเลขบิลด์ของ Proxyman
`get_proxy_status`	ส่งคืนสถานะการบันทึก, พอร์ตพร็อกซี และสถานะ SSL proxying
`get_flows`	แสดงรายการโฟลว์ HTTP/HTTPS ที่จับได้พร้อมตัวกรองเสริม (`limit`, `host_filter`, `method_filter`, `status_filter`)
`get_flow_detail`	ส่งคืนรายละเอียดทั้งหมดของโฟลว์เฉพาะ รวมถึงส่วนหัว, ตัวอย่างเนื้อหา, พารามิเตอร์คิวรี และคุกกี้
`list_rules`	แสดงรายการกฎการดีบักทั้งหมด (เบรกพอยต์, map local, map remote, blacklist)
`get_ssl_proxying_list`	ส่งคืนรายการโดเมนที่รวม/ยกเว้น SSL proxying
`get_certificate_status`	ส่งคืนสถานะการติดตั้งใบรับรองหลัก

เครื่องมือเขียน

เครื่องมือ	คำอธิบาย	พารามิเตอร์ที่จำเป็น
`create_breakpoint`	สร้างเบรกพอยต์เพื่อหยุด/ตรวจสอบคำขอที่ตรงกัน	`url` (รูปแบบ)
`create_map_local`	ส่งคืนการตอบสนองที่กำหนดเองสำหรับ URL ที่ตรงกัน	`url` (รูปแบบ)
`create_map_remote`	เปลี่ยนเส้นทางคำขอจาก URL หนึ่งไปยังอีก URL หนึ่ง	`from_url`, `to_url`
`create_blacklist`	บล็อกคำขอที่ตรงกับรูปแบบ URL	`url` (รูปแบบ)
enable_scripting_tool	สร้าง Script
`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 proxying
get_flows	รับ HTTP/HTTPS flows ล่าสุดจากแหล่งข้อมูลเซสชันที่ใช้งานอยู่ของ Proxyman
get_flow_detail	รับข้อมูลโดยละเอียดเกี่ยวกับ flow เฉพาะ รวมถึง headers, body, query params และ cookies
list_rules	แสดงรายการกฎการดีบักที่ใช้งานอยู่ทั้งหมด (breakpoints, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist)
get_ssl_proxying_list	รับการกำหนดค่า SSL Proxying ปัจจุบัน รวมถึงสถานะการเปิดใช้งานและรายการโดเมน
create_breakpoint	สร้างกฎ breakpoint ใหม่เพื่อหยุดและตรวจสอบ/แก้ไขคำขอหรือการตอบกลับที่ตรงกับรูปแบบ URL
create_map_local	สร้างกฎ Map Local เพื่อส่งคืนการตอบกลับที่กำหนดเองสำหรับคำขอที่ตรงกัน
create_map_remote	สร้างกฎ Map Remote เพื่อเปลี่ยนเส้นทางคำขอจาก URL หนึ่งไปยังอีก URL หนึ่ง
create_blacklist	สร้างกฎ Blacklist เพื่อบล็อกคำขอที่ตรงกับรูปแบบ URL
create_scripting_rule	สร้างกฎ Scripting ด้วย JavaScript ที่กำหนดเองเพื่อแก้ไขคำขอ/การตอบกลับ
enable_ssl_proxying	เปิดใช้งาน SSL Proxying สำหรับโดเมนเฉพาะเพื่อถอดรหัสทราฟฟิก HTTPS
clear_session	ล้าง flows ที่ถูกจับทั้งหมดจากเซสชันปัจจุบัน
toggle_recording	เริ่มหรือหยุดการบันทึกทราฟฟิก HTTP
export_flow_curl	ส่งออกคำขอ HTTP ที่ถูกจับเป็นคำสั่ง cURL
filter_flows	กรอง HTTP/HTTPS flows ที่ถูกจับโดยใช้เกณฑ์ตัวกรองขั้นสูง
get_certificate_status	รับสถานะปัจจุบันของใบรับรอง root ของ Proxyman
install_certificate	ติดตั้งและเชื่อถือใบรับรอง root CA ของ Proxyman
uninstall_certificate	ลบใบรับรอง root CA ของ Proxyman ออกจาก Keychain
inject_terminal	เปิดแอปเทอร์มินัลพร้อมตัวแปรสภาพแวดล้อมพร็อกซีของ Proxyman ที่ถูกฉีดเข้าไป
get_terminal_manual_command	รับคำสั่ง bash source สำหรับตั้งค่าตัวแปรสภาพแวดล้อมพร็อกซีด้วยตนเอง
answer_setup_question	ตอบคำถามการตั้งค่าเกี่ยวกับการจับ HTTPS จาก iOS, Android, เบราว์เซอร์ ฯลฯ
search_docs	ค้นหาดัชนีเอกสารการตั้งค่าและการแก้ไขปัญหาในตัวของ Proxyman
list_setup_workflows	แสดงรายการเวิร์กโฟลว์การตั้งค่าที่ Proxyman MCP สามารถแนะนำผู้ใช้ได้
list_popular_workflows	แสดงรายการเวิร์กโฟลว์การตั้งค่ายอดนิยมโดยใช้การจัดอันดับสำรองที่คัดสรรโดย Proxyman
open_proxyman_screen	เปิดหน้าจอคู่มือหรือการตั้งค่าเฉพาะของ Proxyman ในแอป macOS
run_guided_setup	เรียกใช้การทำงานอัตโนมัติแบบคลิกเดียวใน Proxyman สำหรับเบราว์เซอร์หรืออีมูเลเตอร์ Android
list_reverse_proxies	แสดงรายการรายการ Reverse Proxy ที่กำหนดค่าไว้
create_reverse_proxy	สร้างรายการ Reverse Proxy สำหรับ localhost หรือการกำหนดเส้นทางพอร์ตภายในแบบกำหนดเอง
generate_code	สร้างโค้ดจาก HTTP flow ที่ถูกจับใน 18+ ภาษา/เฟรมเวิร์ก
create_dns_spoofing	สร้างกฎ DNS Spoofing เพื่อเปลี่ยนเส้นทางชื่อโฮสต์ไปยังที่อยู่ IP อื่น
list_dns_spoofing	แสดงรายการกฎ DNS Spoofing ทั้งหมดและสถานะการเปิดใช้งาน
update_dns_spoofing	อัปเดตกฎ DNS Spoofing ที่มีอยู่
get_external_proxy	รับการกำหนดค่า External Proxy (upstream proxy) ปัจจุบัน
set_external_proxy	กำหนดการตั้งค่า External Proxy สำหรับชนิดโปรโตคอลเฉพาะ
toggle_no_caching	สลับคุณสมบัติ 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 และเทมเพลตพร้อมท์สำหรับไคลเอนต์แชท
รองรับการสร้าง/แสดงรายการ reverse proxy

ความปลอดภัย

เซิร์ฟเวอร์ผูกกับ 127.0.0.1 เท่านั้น (ไม่มีการเปิดเผยเครือข่าย)
โทเค็นการเข้ารหัสต่อเซสชันเก็บไว้ใน ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
ไฟล์ handshake มีสิทธิ์ 0600 (เข้าถึงได้เฉพาะเจ้าของ)
ข้อมูลที่ละเอียดอ่อน (auth tokens, รหัสผ่าน, API keys) จะถูกปกปิดโดยอัตโนมัติในการตอบกลับ