Proxyman MCP

आधिकारिक

Proxyman MCP AI को HTTP ट्रैफिक का निरीक्षण करने, डिबगिंग नियम बनाने और Proxyman को नियंत्रित करने की अनुमति देता है - यह सब प्राकृतिक भाषा वार्तालापों के माध्यम से।

Proxyman MCP के साथ आप क्या कर सकते हैं?

  • कैप्चर किए गए ट्रैफ़िक का निरीक्षण करें — अपने सहायक से हाल के HTTP/HTTPS अनुरोधों को होस्ट, विधि, या स्थिति कोड द्वारा फ़िल्टर करके दिखाने के लिए कहें।
  • डिबगिंग नियम बनाएं — अपने सहायक से ब्रेकपॉइंट सेट करने, स्थानीय/रिमोट नियम मैप करने, या ट्रैफ़िक को संशोधित या ब्लॉक करने के लिए URL ब्लैकलिस्ट करने को कहें।
  • अनुरोधों को cURL के रूप में निर्यात करें — किसी भी कैप्चर किए गए फ़्लो को साझा करने या दोबारा चलाने के लिए एक चलाने योग्य cURL कमांड में बदलें।
  • SSL प्रॉक्सिंग प्रबंधित करें — विशिष्ट डोमेन के लिए HTTPS डिक्रिप्शन सक्षम करें या वर्तमान SSL प्रॉक्सिंग कॉन्फ़िगरेशन जांचें।
  • रिकॉर्डिंग सत्र नियंत्रित करें — ट्रैफ़िक कैप्चर शुरू या बंद करें, वर्तमान सत्र साफ़ करें, या प्रॉक्सी स्थिति जांचें।
  • फ़्लो से कोड जनरेट करें — अपने सहायक से कैप्चर किए गए अनुरोधों से 18+ भाषाओं और फ्रेमवर्क में कोड स्निपेट उत्पन्न करने के लिए कहें।

दस्तावेज़

संपूर्ण दस्तावेज़ अनुक्रमणिका के लिए, llms.txt देखें। दस्तावेज़ पृष्ठों के Markdown संस्करण पृष्ठ URL में .md जोड़कर उपलब्ध हैं; यह पृष्ठ Markdown के रूप में उपलब्ध है।

MCP

Codex, Claude Code, या Cursor को Proxyman MCP से कनेक्ट करें ताकि कैप्चर किए गए HTTP/HTTPS ट्रैफ़िक का निरीक्षण किया जा सके और अपने AI सहायक से डिबगिंग नियम बनाए जा सकें।

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 सर्वर - Proxyman ऐप के अंदर localhost पर टोकन-आधारित प्रमाणीकरण के साथ चलता है
  • MCP CLI सर्वर - एक stdio-आधारित MCP सर्वर जिससे AI टूल कनेक्ट होते हैं, जो Proxyman को कमांड अग्रेषित करता है

{% hint style="info" %} अपने AI एजेंटों के लिए Proxyman SKILL.md देखें {% endhint %}

✅ उदाहरण प्रॉम्प्ट

  • मुझे api.example.com पर पिछले 10 API अनुरोध दिखाएं
  • /api/users पर सभी POST अनुरोधों के लिए एक ब्रेकपॉइंट बनाएं
  • विफल अनुरोध को cURL कमांड के रूप में निर्यात करें
  • *.stripe.com के लिए SSL प्रॉक्सीिंग सक्षम करें
  • स्टेटस कोड, हेडर, बॉडी बदलने के लिए एक नया स्क्रिप्ट बनाएं
  • दिए गए URL के साथ Map Local, Breakpoint टूल बनाएं
Use Claude Code to create the Script

2. लाभ

लाभविवरण
AI-संचालित डिबगिंगकैप्चर किए गए ट्रैफ़िक का विश्लेषण करने, विशिष्ट अनुरोध खोजने, या API प्रतिक्रियाओं को समझाने के लिए AI से पूछें
हैंड्स-फ्री नियम निर्माणसंवाद के माध्यम से ब्रेकपॉइंट, मैप लोकल/रिमोट नियम बनाएं
तेज़ वर्कफ़्लोसंदर्भ बदले बिना cURL कमांड निर्यात करें, फ्लो फ़िल्टर करें, और सत्र प्रबंधित करें
डिज़ाइन द्वारा सुरक्षितप्रति-सत्र टोकन प्रमाणीकरण के साथ केवल localhost सर्वर
IDE एकीकरणCursor और अन्य MCP-संगत टूल के साथ सहजता से काम करता है

3. Proxyman MCP कैसे जोड़ें

  1. Proxyman में MCP सक्षम करें
    • Proxyman खोलें → सेटिंग्स → MCP टैब
    • Enable MCP Server to start the MCP Server टॉगल करें
  2. अपना MCP क्लाइंट चुनें: Proxyman सेटिंग्स → 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 %}

मैनुअल

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"
    }
  }
}
  1. Proxyman MCP का उपयोग शुरू करें
  • सुनिश्चित करें कि Proxyman चल रहा है
  • अपने AI सहायक से Proxyman के साथ इंटरैक्ट करने के लिए कहें, उदाहरण के लिए: "api.example.com पर नवीनतम अनुरोध दिखाएं।"
  • यदि क्लाइंट Proxyman नहीं ढूंढ पाता है, तो जांचें कि MCP सक्षम है और कॉन्फ़िगर किया गया ऐप पथ सही है, फिर क्लाइंट को पुनः कनेक्ट करें। यदि यह कनेक्ट होता है लेकिन कोई फ्लो नहीं मिलता है, तो एक नया अनुरोध करें और मिसिंग-ट्रैफ़िक चेकलिस्ट का उपयोग करें।

4. उपलब्ध टूल

केवल-पढ़ने वाले टूल

टूलविवरण
get_versionProxyman संस्करण और बिल्ड नंबर लौटाता है
get_proxy_statusरिकॉर्डिंग स्थिति, प्रॉक्सी पोर्ट, और SSL प्रॉक्सीिंग स्थिति लौटाता है
get_flowsवैकल्पिक फ़िल्टर के साथ कैप्चर किए गए HTTP/HTTPS फ्लो सूचीबद्ध करता है (limit, host_filter, method_filter, status_filter)
get_flow_detailहेडर, बॉडी पूर्वावलोकन, क्वेरी पैरामीटर, और कुकीज़ सहित किसी विशिष्ट फ्लो का पूरा विवरण लौटाता है
list_rulesसभी डिबगिंग नियम सूचीबद्ध करता है (ब्रेकपॉइंट, मैप लोकल, मैप रिमोट, ब्लैकलिस्ट)
get_ssl_proxying_listSSL प्रॉक्सीिंग शामिल/बहिष्कृत डोमेन सूचियाँ लौटाता है
get_certificate_statusरूट प्रमाणपत्र स्थापना स्थिति लौटाता है

लेखन टूल

टूलविवरणआवश्यक पैरामीटर
create_breakpointमिलान वाले अनुरोधों को रोकने/निरीक्षण करने के लिए ब्रेकपॉइंट बनाता हैurl (पैटर्न)
create_map_localमिलान वाले URL के लिए कस्टम प्रतिक्रियाएँ लौटाता हैurl (पैटर्न)
create_map_remoteअनुरोधों को एक URL से दूसरे URL पर पुनर्निर्देशित करता हैfrom_url, to_url
create_blacklistURL पैटर्न से मिलान वाले अनुरोधों को ब्लॉक करता है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_proxymanProxyman नहीं चल रहा हो तो उसे लॉन्च करता है
quit_proxymanProxyman ऐप बंद करता है

चेंजलॉग

MCP v3 (Proxyman macOS ≥ 6.8.0)

नामविवरण
get_versionवर्तमान Proxyman macOS ऐप संस्करण और बिल्ड नंबर प्राप्त करें
get_proxy_statusरिकॉर्डिंग स्थिति, पोर्ट नंबर, और SSL प्रॉक्सी स्थिति सहित वर्तमान प्रॉक्सी स्थिति प्राप्त करें
get_flowsProxyman के सक्रिय सत्र डेटा स्रोत से हाल के HTTP/HTTPS फ्लो प्राप्त करें
get_flow_detailहेडर, बॉडी, क्वेरी पैरामीटर, और कुकीज़ सहित किसी विशिष्ट फ्लो के बारे में विस्तृत जानकारी प्राप्त करें
list_rulesसभी सक्रिय डिबगिंग नियम सूचीबद्ध करें (ब्रेकपॉइंट, मैप लोकल, मैप रिमोट, ब्लैकलिस्ट, स्क्रिप्टिंग, DNS स्पूफिंग, नेटवर्क कंडीशन, व्हाइटलिस्ट)
get_ssl_proxying_listसक्षम स्थिति और डोमेन सूचियों सहित वर्तमान SSL प्रॉक्सी कॉन्फ़िगरेशन प्राप्त करें
create_breakpointURL पैटर्न से मेल खाने वाले अनुरोधों या प्रतिक्रियाओं को रोकने और निरीक्षण/संशोधित करने के लिए नया ब्रेकपॉइंट नियम बनाएं
create_map_localमेल खाने वाले अनुरोधों के लिए कस्टम प्रतिक्रिया लौटाने के लिए मैप लोकल नियम बनाएं
create_map_remoteअनुरोधों को एक URL से दूसरे URL पर पुनर्निर्देशित करने के लिए मैप रिमोट नियम बनाएं
create_blacklistURL पैटर्न से मेल खाने वाले अनुरोधों को ब्लॉक करने के लिए ब्लैकलिस्ट नियम बनाएं
create_scripting_ruleअनुरोधों/प्रतिक्रियाओं को संशोधित करने के लिए कस्टम JavaScript के साथ स्क्रिप्टिंग नियम बनाएं
enable_ssl_proxyingHTTPS ट्रैफ़िक को डिक्रिप्ट करने के लिए किसी विशिष्ट डोमेन के लिए SSL प्रॉक्सी सक्षम करें
clear_sessionवर्तमान सत्र से सभी कैप्चर किए गए फ्लो साफ़ करें
toggle_recordingHTTP ट्रैफ़िक रिकॉर्ड करना शुरू या बंद करें
export_flow_curlकैप्चर किए गए HTTP अनुरोध को cURL कमांड के रूप में निर्यात करें
filter_flowsउन्नत फ़िल्टर मानदंडों का उपयोग करके कैप्चर किए गए HTTP/HTTPS फ्लो फ़िल्टर करें
get_certificate_statusProxyman के रूट प्रमाणपत्र की वर्तमान स्थिति प्राप्त करें
install_certificateProxyman रूट CA प्रमाणपत्र स्थापित करें और उस पर भरोसा करें
uninstall_certificateKeychain से Proxyman रूट CA प्रमाणपत्र हटाएं
inject_terminalProxyman प्रॉक्सी पर्यावरण चर इंजेक्ट किए गए टर्मिनल ऐप लॉन्च करें
get_terminal_manual_commandप्रॉक्सी पर्यावरण चर मैन्युअल रूप से सेट करने के लिए bash स्रोत कमांड प्राप्त करें
answer_setup_questioniOS, Android, ब्राउज़र आदि से HTTPS कैप्चर करने के बारे में सेटअप प्रश्नों के उत्तर दें
search_docsअंतर्निहित Proxyman सेटअप और समस्या निवारण दस्तावेज़ अनुक्रमणिका खोजें
list_setup_workflowsसमर्थित सेटअप वर्कफ़्लो सूचीबद्ध करें जिनके माध्यम से Proxyman MCP उपयोगकर्ताओं का मार्गदर्शन कर सकता है
list_popular_workflowsProxyman के क्यूरेटेड फ़ॉलबैक रैंकिंग का उपयोग करके लोकप्रिय सेटअप वर्कफ़्लो सूचीबद्ध करें
open_proxyman_screenmacOS ऐप में एक विशिष्ट Proxyman गाइड या सेटअप स्क्रीन खोलें
run_guided_setupब्राउज़र या Android एमुलेटर के लिए Proxyman में एक-क्लिक स्वचालन चलाएं
list_reverse_proxiesकॉन्फ़िगर किए गए रिवर्स प्रॉक्सी प्रविष्टियाँ सूचीबद्ध करें
create_reverse_proxylocalhost या कस्टम लोकल पोर्ट रूटिंग के लिए रिवर्स प्रॉक्सी प्रविष्टि बनाएं
generate_codeकैप्चर किए गए HTTP फ्लो से 18+ भाषाओं/फ्रेमवर्क में कोड उत्पन्न करें
create_dns_spoofingहोस्टनाम को विभिन्न IP पते पर पुनर्निर्देशित करने के लिए DNS स्पूफिंग नियम बनाएं
list_dns_spoofingसभी DNS स्पूफिंग नियम और उनकी सक्षम स्थिति सूचीबद्ध करें
update_dns_spoofingमौजूदा DNS स्पूफिंग नियम अपडेट करें
get_external_proxyवर्तमान बाहरी प्रॉक्सी (अपस्ट्रीम प्रॉक्सी) कॉन्फ़िगरेशन प्राप्त करें
set_external_proxyकिसी विशिष्ट प्रोटोकॉल प्रकार के लिए बाहरी प्रॉक्सी सेटिंग कॉन्फ़िगर करें
toggle_no_cachingनो कैशिंग सुविधा टॉगल करें (कैश-संबंधित हेडर हटाता है)
inject_electronProxyman प्रॉक्सी कॉन्फ़िगरेशन इंजेक्ट किए गए Electron ऐप लॉन्च करें
open_proxymanProxyman macOS एप्लिकेशन लॉन्च करें
quit_proxymanProxyman 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 कुंजियाँ) प्रतिक्रियाओं में स्वचालित रूप से संपादित किया जाता है