Proxyman MCP

आधिकारिक

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

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

  • कैप्चर किए गए ट्रैफ़िक का निरीक्षण करें — AI से get_flows के साथ हाल के HTTP फ़्लो की सूची बनाने और get_flow_detail के साथ पूर्ण अनुरोध/प्रतिक्रिया विवरण में जाने का अनुरोध करें।
  • बातचीत के माध्यम से डिबगिंग नियम बनाएंcreate_breakpoint, create_map_local, create_map_remote, और create_blacklist का उपयोग करके ब्रेकपॉइंट सेट करें, लोकल मैप करें, रिमोट मैप करें, या ब्लैकलिस्ट नियम बनाएं।
  • प्रॉक्सी सत्र को नियंत्रित करेंtoggle_recording के साथ रिकॉर्डिंग शुरू या बंद करें और clear_session के साथ सभी कैप्चर किए गए फ़्लो को साफ़ करें।
  • अनुरोधों को कोड के रूप में निर्यात करेंexport_flow_curl के साथ कैप्चर किए गए फ़्लो को cURL कमांड के रूप में निर्यात करें या generate_code का उपयोग करके 18+ भाषाओं में क्लाइंट कोड जनरेट करें।
  • SSL डिक्रिप्शन प्रबंधित करेंenable_ssl_proxying के साथ किसी डोमेन के लिए HTTPS डिक्रिप्शन सक्षम करें और get_certificate_status के माध्यम से प्रमाणपत्र स्थापना स्थिति की जाँच करें।
  • उन्नत प्रॉक्सी सेटिंग्स कॉन्फ़िगर करेंset_external_proxy के साथ एक अपस्ट्रीम बाहरी प्रॉक्सी सेट करें, create_reverse_proxy के साथ रिवर्स प्रॉक्सी एंट्री बनाएं, या नो-कैशिंग व्यवहार टॉगल करें।

दस्तावेज़

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

MCP

1. Proxyman MCP क्या है?

Proxyman MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) एक सुविधा है जो AI सहायकों (Claude, Cursor, और अन्य MCP-संगत उपकरण) को Proxyman macOS ऐप के साथ सीधे संवाद करने में सक्षम बनाती है। यह AI को HTTP ट्रैफ़िक का निरीक्षण करने, डिबगिंग नियम बनाने और Proxyman को नियंत्रित करने की अनुमति देता है - सब कुछ प्राकृतिक भाषा वार्तालापों के माध्यम से।

आर्किटेक्चर में दो घटक शामिल हैं:

  • MCP HTTP सर्वर - टोकन-आधारित प्रमाणीकरण के साथ localhost पर Proxyman ऐप के अंदर चलता है
  • 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 के साथ मैप लोकल, ब्रेकपॉइंट उपकरण बनाएँ

2. लाभ

लाभविवरण
AI-संचालित डिबगिंगAI से कैप्चर किए गए ट्रैफ़िक का विश्लेषण करने, विशिष्ट अनुरोध खोजने, या API प्रतिक्रियाओं की व्याख्या करने के लिए कहें
हैंड्स-फ़्री नियम निर्माणवार्तालाप के माध्यम से ब्रेकपॉइंट, मैप लोकल/रिमोट नियम बनाएँ
तेज़ वर्कफ़्लोसंदर्भ बदले बिना cURL कमांड निर्यात करें, फ़्लो फ़िल्टर करें और सत्र प्रबंधित करें
डिज़ाइन द्वारा सुरक्षितप्रति-सत्र टोकन प्रमाणीकरण के साथ केवल-लोकलहोस्ट सर्वर
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"
    }
  }
}
  1. Proxyman MCP का उपयोग शुरू करें
  • सुनिश्चित करें कि Proxyman चल रहा है
  • अपने AI सहायक से Proxyman के साथ संवाद करने के लिए कहें।

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 से दूसरे पर पुनर्निर्देशित करता हैfrom_url, to_url
create_blacklistURL पैटर्न से मिलान करने वाले अनुरोधों को ब्लॉक करता हैurl (पैटर्न)
enable_scripting_toolस्क्रिप्ट बनाएँ
enable_ssl_proxyingकिसी डोमेन के लिए HTTPS डिक्रिप्शन सक्षम करता हैdomain

सत्र नियंत्रण

उपकरणविवरण
clear_sessionवर्तमान सत्र से सभी कैप्चर किए गए फ़्लो साफ़ करता है
toggle_recordingट्रैफ़िक रिकॉर्डिंग प्रारंभ या बंद करता है

फ़्लो संचालन

उपकरणविवरण
export_flow_curlकैप्चर किए गए अनुरोध को निष्पादन योग्य cURL कमांड के रूप में निर्यात करता है
filter_flowsAND/OR संयोजनों का समर्थन करते हुए कई मानदंडों (url, host, method, status, headers, body) के साथ उन्नत फ़िल्टरिंग

ऐप नियंत्रण

उपकरणविवरण
open_proxymanयदि नहीं चल रहा है तो Proxyman लॉन्च करता है
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अनुरोधों/प्रतिक्रियाओं को संशोधित करने के लिए कस्टम जावास्क्रिप्ट के साथ स्क्रिप्टिंग नियम बनाएं
enable_ssl_proxyingHTTPS ट्रैफ़िक को डिक्रिप्ट करने के लिए किसी विशिष्ट डोमेन के लिए SSL प्रॉक्सीइंग सक्षम करें
clear_sessionवर्तमान सत्र से सभी कैप्चर किए गए प्रवाह साफ़ करें
toggle_recordingHTTP ट्रैफ़िक रिकॉर्ड करना प्रारंभ या बंद करें
export_flow_curlकैप्चर किए गए HTTP अनुरोध को cURL कमांड के रूप में निर्यात करें
filter_flowsउन्नत फ़िल्टर मानदंड का उपयोग करके कैप्चर किए गए HTTP/HTTPS प्रवाह फ़िल्टर करें
get_certificate_statusProxyman के रूट प्रमाणपत्र की वर्तमान स्थिति प्राप्त करें
install_certificateProxyman रूट CA प्रमाणपत्र स्थापित करें और विश्वसनीय बनाएं
uninstall_certificateकीचेन से Proxyman रूट CA प्रमाणपत्र हटाएं
inject_terminalProxyman प्रॉक्सी पर्यावरण चर इंजेक्ट करके टर्मिनल ऐप लॉन्च करें
get_terminal_manual_commandप्रॉक्सी पर्यावरण चर मैन्युअल रूप से सेट करने के लिए बैश स्रोत कमांड प्राप्त करें
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_proxyलोकलहोस्ट या कस्टम स्थानीय पोर्ट रूटिंग के लिए रिवर्स प्रॉक्सी प्रविष्टि बनाएं
generate_code18+ भाषाओं/फ्रेमवर्क में कैप्चर किए गए HTTP प्रवाह से कोड जनरेट करें
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, लोकलहोस्ट और तृतीय-पक्ष लाइब्रेरी को कवर करने वाला अंतर्निहित ज्ञान आधार
  • नए कमांड: 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 कुंजियाँ) प्रतिक्रियाओं में स्वचालित रूप से संपादित किया जाता है