kerlenton/mcpsnoopMCP के लिए Wireshark। आपके AI क्लाइंट और MCP सर्वर के बीच एक पारदर्शी प्रॉक्सी। अपने टर्मिनल में हर कॉल को लाइव देखें, जो यह पाता है उस पर CI विफल करें, OpenTelemetry स्पैन निर्यात करें।
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/9109/91d664ea266713affb29238906792777021b43fa6627b13f46382f48ad340a61.png" alt="mcpsnoop" width="440"> </p> **MCP के लिए Wireshark।** mcpsnoop आपके AI क्लाइंट और आपके MCP सर्वर के बीच बैठता है और उनके द्वारा आदान-प्रदान किए गए हर JSON-RPC फ़्रेम को रिकॉर्ड करता है, बिना किसी भी पक्ष में बदलाव किए। इसे अपने टर्मिनल में लाइव देखें, जो मिले उस पर CI को विफल करें, या इसे अपने ट्रेसिंग बैकएंड में OpenTelemetry स्पैन के रूप में भेजें। [](https://github.com/kerlenton/mcpsnoop/actions/workflows/ci.yml) [](https://pkg.go.dev/github.com/kerlenton/mcpsnoop) [](LICENSE) [](https://github.com/marketplace/actions/mcpsnoop) <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/9109/30466d77be15250e4bab6639e48a4cd5b0d44cd96e48606b60c6bacb67c15c3d.gif" alt="mcpsnoop demo"> </p> ## समस्या आधिकारिक [MCP Inspector](https://github.com/modelcontextprotocol/inspector) अपने स्वयं के क्लाइंट के रूप में कनेक्ट होता है, इसलिए यह कभी नहीं देखता कि *आपका* क्लाइंट (Cursor, Claude Code, Codex) वास्तव में आपके सर्वर को क्या भेजता है। और जो कुछ भी अनुरोध आने की प्रतीक्षा करता है वह उस कॉल को नहीं दिखा सकता जो मॉडल ने कभी नहीं की, या गलत आर्ग्युमेंट के साथ की। जब कोई टूल चुपचाप कॉल नहीं होता, क्षमताएँ मेल नहीं खातीं, या कोई कॉल बस अटक जाती है, तो आप लॉग खोदते और अनुमान लगाते रह जाते हैं। **इसके बजाय mcpsnoop वास्तविक डेटा पथ में बैठता है।** अपने सर्वर कमांड को इसके साथ रैप करें और हर JSON-RPC फ़्रेम को लाइव देखें, जैसे आपका वास्तविक क्लाइंट और सर्वर बातचीत करते हैं। ## CI में यह पृष्ठ [mcpsnoop GitHub Action](https://github.com/marketplace/actions/mcpsnoop) की लिस्टिंग भी है, इसलिए यहाँ इसका पूरा विवरण है। यह एक कैप्चर किए गए सत्र की जाँच करता है, हर निष्कर्ष को कोड स्कैनिंग अलर्ट के रूप में दर्ज करता है, और जिस पर आपने गेट लगाया है उस पर जॉब को विफल कर देता है। ```yaml permissions: security-events: write contents: read steps: - uses: kerlenton/[email protected] with: session: artifacts/session.jsonl ``` कैप्चर हाथ में नहीं है? अपने ही क्लाइंट के साथ एक बार एक सत्र रिकॉर्ड करें, उसे कमिट करें, और एक्शन को हर बिल्ड के विरुद्ध उसे रीप्ले करने दें। CI में कोई मॉडल और कोई API कुंजी नहीं चलती। रीप्ले को किसी भी कैप्चर की तरह जाँचा जाता है, और जब सर्वर रिकॉर्डिंग से भी बदतर हो जाता है तो जॉब विफल भी हो जाता है। Streamable HTTP के माध्यम से पहुँचे जाने वाले सर्वर को उसके एंडपॉइंट के साथ `target` मिलता है, और एक रिकॉर्डिंग किसी भी ट्रांसपोर्ट पर रीप्ले होती है। ```yaml steps: - uses: kerlenton/[email protected] with: replay: tests/mcp/claude-code-session.jsonl server: node dist/index.js ``` जिस भी रिलीज़ को आप चाहें उसे पिन करें। सबसे नई रिलीज़ [releases page](https://github.com/kerlenton/mcpsnoop/releases) पर है। हर इनपुट और आउटपुट नीचे [The GitHub Action](#the-github-action) में है, और हर वह सिग्नल जिस पर चेक विफल हो सकता है, [docs/CI.md](https://github.com/kerlenton/mcpsnoop/blob/main/docs/CI.md) में है। ## OpenTelemetry MCP रिवीज़न 2026-07-28 प्रोटोकॉल-स्तरीय Logging को अप्रचलित करता है और कार्यान्वयनों को stdio पर `stderr` की ओर, या संरचित अवलोकनशीलता के लिए OpenTelemetry की ओर जाने का निर्देश देता है। mcpsnoop क्लाइंट या सर्वर को छुए बिना दोनों को कवर करता है। एक stdio सर्वर की `stderr` पंक्तियाँ उसके फ़्रेमों के बगल में स्ट्रीम में दिखाई देती हैं, और हर अनुरोध एक स्पैन बन जाता है जो [MCP के लिए OpenTelemetry semantic conventions](https://github.com/open-telemetry/semantic-conventions-genai/tree/main/model/mcp) का पालन करता है। ```bash mcpsnoop export -T otlp -o trace.json # spans from a capture mcpsnoop --otlp-endpoint http://localhost:4318/v1/traces -- node build/index.js # spans as calls complete ``` एक टूल कॉल `tools/call search` नाम के span के रूप में आता है, जिसमें `mcp.method.name`, `gen_ai.tool.name` और `error.type` होते हैं, इसलिए यह mcpsnoop के लिए बनाए गए डैशबोर्ड के बजाय MCP के लिए बनाए गए डैशबोर्ड में पहुँचता है। Prometheus के लिए लाइव टूल मेट्रिक्स बस एक फ़्लैग दूर हैं। दोनों [docs/OPENTELEMETRY.md](https://github.com/kerlenton/mcpsnoop/blob/main/docs/OPENTELEMETRY.md) में हैं। ## त्वरित शुरुआत बिना कुछ सेटअप किए, इसे तुरंत देखें। ```bash mcpsnoop demo ``` वास्तविक उपयोग के लिए, अपने सर्वर को अपने क्लाइंट के MCP कॉन्फ़िग में लपेटें। ```json { "mcpServers": { "my-server": { "command": "mcpsnoop", "args": ["--", "node", "build/index.js"] } } } ``` `--` के बाद जो कुछ भी है वह वह कमांड है जो सामान्य रूप से आपके सर्वर को लॉन्च करता है। जो आप पहले से उपयोग करते हैं उसे इसमें बदल दें, जैसे `python server.py`, `npx -y @scope/server`, या कोई कंपाइल किया गया बाइनरी। Claude Desktop पर आपको यह संपादन हाथ से करने की आवश्यकता नहीं है। ```bash mcpsnoop wrap my-server # route my-server through mcpsnoop mcpsnoop unwrap my-server # put it back ``` `wrap` `claude_desktop_config.json` को ढूँढता है, पहली बार इसे `claude_desktop_config.json.mcpsnoop.bak` में कॉपी करता है, और केवल उसी सर्वर की प्रविष्टि को फिर से लिखता है, इसलिए आपकी फ़ॉर्मेटिंग और हर दूसरा सर्वर अछूता रहता है। फिर से लिखी गई प्रविष्टि के अंदर कुंजियाँ वर्णानुक्रम में वापस आ जाती हैं। `unwrap` फ़ाइल को पुनर्स्थापित करता है, और जब कोई सर्वर रैप नहीं रहता तो बैकअप हटा देता है। दोनों में से किसी के बाद Claude Desktop को पुनः आरंभ करें, क्योंकि MCP सर्वर स्टार्टअप पर एक बार लॉन्च होते हैं। फिर अपने क्लाइंट का सामान्य रूप से उपयोग करें और UI खोलें। ```bash mcpsnoop ``` कोई फ़्लैग नहीं, कोई सॉकेट पाथ नहीं, याद रखने के लिए कोई स्टार्टअप क्रम नहीं। शिम और UI स्वयं एक-दूसरे को खोज लेते हैं, और UI डिस्क से पिछले सत्रों को बैकफ़िल करता है। स्ट्रीमेबल-HTTP सर्वर के लिए, mcpsnoop को रिवर्स प्रॉक्सी के रूप में चलाएँ। ```bash mcpsnoop http --target http://localhost:3000/mcp --listen :7000 ``` हर प्रतिक्रिया का HTTP स्टेटस स्ट्रीम में दिखता है, इसलिए जिस प्रतिक्रिया में अपना कोई JSON-RPC संदेश नहीं होता, वह भी कुछ न होने के बजाय एक दृश्यमान फ़्रेम ही होती है। इसमें 401 चैलेंज, अस्वीकृत Origin पर 403, किसी नोटिफ़िकेशन को स्वीकार करने वाला 202, और तब 502 शामिल है जब लक्ष्य तक पहुँचा ही न जा सके। 401 का `WWW-Authenticate` हेडर ज्यों का त्यों रखा जाता है और इंस्पेक्टर में दिखाया जाता है, क्योंकि यह प्रमाणीकरण स्कीम और आगे जाने के लिए रिसोर्स मेटाडेटा बताता है। TUI में `status:401` से स्टेटस के आधार पर फ़िल्टर करें, या `status:err` से किसी भी विफलता के आधार पर। 4xx या 5xx को त्रुटि माना जाता है, इसलिए डिफ़ॉल्ट `mcpsnoop check` रन उस पर विफल हो जाता है, और जिस कॉल का यह उत्तर देता है वह अभी भी प्रतीक्षारत होने के बजाय विफल के रूप में दिखता है। अपना कोई सर्वर नहीं? एक प्रकाशित टेस्ट सर्वर के विरुद्ध, अपने ही क्लाइंट से चलाकर [इसे वास्तव में आज़माएँ](https://github.com/kerlenton/mcpsnoop/blob/main/docs/TRY_IT.md)। किसी सत्र का निरीक्षण उसके हो चुकने के बाद करने के लिए, [लॉग से पिछले सत्रों की समीक्षा करें](https://github.com/kerlenton/mcpsnoop/blob/main/docs/POST_MORTEM.md) देखें। ## इंस्टॉल ### npm किसी Go टूलचेन की आवश्यकता नहीं। अधिकांश MCP सर्वर Node या Python में लिखे जाते हैं, इसलिए यह सबसे छोटा रास्ता है। ```bash npx mcpsnoop -- node build/index.js ``` npm पैकेज अपना कोई कोड नहीं भेजता। छह प्लेटफ़ॉर्म पैकेजों में से प्रत्येक में एक बिल्ड होता है, और npm केवल वही इंस्टॉल करता है जो आपकी मशीन से मेल खाता है, इसलिए इंस्टॉल के समय डाउनलोड करने के लिए कुछ नहीं है और प्रॉक्सी में अनब्लॉक करने के लिए कुछ नहीं है। इसे हर रन पर फ़ेच करने के बजाय बनाए रखने के लिए, `npm i -g mcpsnoop`। ### Homebrew ```bash brew install mcpsnoop ``` ### Go ```bash go install github.com/kerlenton/mcpsnoop/cmd/mcpsnoop@latest ``` हर प्लेटफ़ॉर्म के लिए पहले से बने बाइनरी [Releases](https://github.com/kerlenton/mcpsnoop/releases) पेज पर उपलब्ध हैं। mcpsnoop bash, zsh, fish और PowerShell के लिए कम्प्लीशन के साथ आता है। सेटअप के चरणों के लिए `mcpsnoop completion <shell> --help` चलाएँ, जिसमें कम्प्लीशन सक्षम करना और आपके OS के लिए इंस्टॉल पथ शामिल हैं। ## कमांड | कमांड | यह क्या करता है | |---|---| | `mcpsnoop -- <server>` | एक stdio सर्वर को पारदर्शी शिम के रूप में रैप करता है | | `mcpsnoop` | लाइव TUI खोलता है | | `mcpsnoop --metrics-listen <addr>` | एक हेडलेस हब चलाता है और लाइव Prometheus मेट्रिक्स उजागर करता है | | `mcpsnoop http --target <url>` | एक streamable-HTTP सर्वर को प्रॉक्सी करता है | | `mcpsnoop export` | एक सत्र को json, html, text, har, या otlp में रेंडर करता है | | `mcpsnoop check` | त्रुटियों, अमान्य फ़्रेम, चेतावनियों जैसे कि कोई टूल परिणाम अपने ही outputSchema को तोड़ रहा हो, रूटिंग बेमेल, अटकी हुई कॉल, देर से आए परिणाम, ऐसी कॉल जो दो बार चली हों, टूल ड्रिफ्ट, ऐसे एनोटेशन जो ढीले पड़ गए हों या कुछ न कहें, या लेटेंसी बजट पर CI को विफल करता है | | `mcpsnoop baseline` | विश्वसनीय टूल परिभाषाओं का निरीक्षण, स्वीकृति, या रीसेट करता है | | `mcpsnoop diff` | दो कैप्चर किए गए सत्रों के बीच टूल और कॉल की तुलना करता है | | `mcpsnoop open` | एक सहेजा गया सत्र TUI में खोलता है | | `mcpsnoop mock <session>` | एक कैप्चर किए गए सत्र को stdio MCP सर्वर के रूप में वापस परोसता है | | `mcpsnoop replay <session> -- <server>` | stdio या Streamable HTTP के ज़रिए, एक रिकॉर्ड किए गए सत्र के क्लाइंट पक्ष के साथ सर्वर को चलाता है, और परिणाम की तुलना रिकॉर्डिंग से करता है | | `mcpsnoop inventory` | इस मशीन पर mcpsnoop के ज़रिए चले हर सर्वर की सूची बनाता है | | `mcpsnoop stats` | हर संग्रहीत कैप्चर को प्रति सर्वर और टूल एक पंक्ति में समेटता है | | `mcpsnoop clients` | दिखाता है कि प्रत्येक MCP क्लाइंट ने वायर पर वास्तव में क्या किया, नाम और संस्करण के अनुसार | | `mcpsnoop prune` | कटऑफ से पुराने सहेजे गए सत्र लॉग हटाता है | | `mcpsnoop wrap <server>` | Claude Desktop के किसी सर्वर को mcpsnoop के ज़रिए रूट करता है | | `mcpsnoop unwrap <server>` | उस सर्वर की प्रविष्टि को वापस पहले जैसा कर देता है | | `mcpsnoop remote <user@host>` | SSH टनल कमांड प्रिंट करता है | | `mcpsnoop demo` | एक स्क्रिप्टेड सत्र चलाता है | पूरी सूची के लिए `mcpsnoop help` चलाएँ, या किसी एक कमांड के फ़्लैग के लिए `mcpsnoop help <command>` चलाएँ। ## इसकी तुलना कैसे होती है इनमें से प्रत्येक एक अलग प्रश्न का उत्तर देता है, और कोई टूल कहाँ बैठता है यह तय करता है कि वह किन प्रश्नों का उत्तर दे सकता है। | टूल | यह कहाँ बैठता है | यह किसके लिए है | |---|---|---| | [MCP Inspector](https://github.com/modelcontextprotocol/inspector) | अपना स्वयं का क्लाइंट, आपके सर्वर से जुड़ा | किसी सर्वर को हाथ से आज़माना, ब्राउज़र में या स्क्रिप्टेबल CLI से | | [Snyk Agent Scan](https://github.com/snyk/agent-scan) | अपना स्वयं का क्लाइंट, आपके कॉन्फ़िग में मौजूद सर्वरों को लॉन्च या कनेक्ट करके उनके टूल पढ़ता है | आपकी मशीन पर एजेंट, MCP सर्वर और स्किल्स को प्रॉम्प्ट इंजेक्शन और कमज़ोरियों के लिए स्कैन करना | | [MCP Observatory](https://github.com/KryptosAI/mcp-observatory) | अपना स्वयं का क्लाइंट, आपके सर्वर को टेस्ट, रिकॉर्ड और सत्यापित करने के लिए लॉन्च करता है | CI में सुरक्षा और रिग्रेशन परीक्षण, अटैक सिमुलेशन, स्कीमा ड्रिफ्ट, और रिकॉर्ड, रीप्ले और सत्यापन के साथ | | [mcprec](https://github.com/erphq/mcprec) | वायर पर, क्लाइंट और सर्वर के बीच | एक सत्र को एक बार रिकॉर्ड करना और नेटवर्क के बिना टेस्ट फ़िक्स्चर के रूप में उसे रीप्ले करना | | mcpsnoop | वायर पर, क्लाइंट और सर्वर के बीच | यह देखना कि आपका वास्तविक क्लाइंट और सर्वर क्या कहते हैं, हर बिल्ड के विरुद्ध एक वास्तविक क्लाइंट के सत्र को रीप्ले करना, उस पर CI विफल करना, और उसे OpenTelemetry के रूप में एक्सपोर्ट करना | जो टूल स्वयं क्लाइंट है वह अपनी की गई कॉल देखता है, आपके क्लाइंट की की गई कॉल नहीं, इसलिए वह वह कॉल नहीं दिखा सकता जो आपके मॉडल ने कभी नहीं की या गलत आर्ग्युमेंट के साथ की। एक स्कैनर किसी परिभाषा को पढ़ता है इससे पहले कि आप उस पर भरोसा करें। mcpsnoop देखता है कि आपके भरोसा करने के बाद क्या होता है, जिसमें यह भी शामिल है कि क्या परिभाषा बाद में बदलती है। ## यह कैसे काम करता है <p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/architecture-dark.svg"> <img alt="mcpsnoop आपके AI क्लाइंट और आपके MCP सर्वरों के बीच पाइप में बैठता है, हर JSON-RPC फ़्रेम को लाइव टर्मिनल UI में कॉपी करता है" src="https://raw.githubusercontent.com/kerlenton/mcpsnoop/HEAD/assets/architecture-light.svg" width="760"> </picture> </p> mcpsnoop एक ही बाइनरी में दो भूमिकाएँ है। `mcpsnoop -- <server>` वह पारदर्शी शिम है जिसे आपका क्लाइंट स्पॉन करता है, जो बाइट्स को वैसे ही फ़ॉरवर्ड करता है और साथ ही हर फ़्रेम की एक प्रति हब को भेजता है। बिना किसी आर्ग्युमेंट के `mcpsnoop` वही हब और उसका लाइव TUI है। ये एक सुविख्यात सॉकेट और ऑन-डिस्क लॉग्स के माध्यम से जुड़ते हैं, इसलिए किसी को भी पहले शुरू होने की आवश्यकता नहीं है। चूँकि यह वास्तविक पाइप में बैठता है, Inspector की तरह किनारे पर नहीं, यह ठीक वही देखता है जो आपके वास्तविक क्लाइंट और सर्वर एक-दूसरे से कहते हैं, चाहे सर्वर किसी भी भाषा में लिखा गया हो। इसकी मेमोरी और इसकी डिस्क को क्या सीमित करता है, यह [docs/HOW_IT_WORKS.md](https://github.com/kerlenton/mcpsnoop/blob/main/docs/HOW_IT_WORKS.md) में है। ## GitHub Action नीचे दिया गया सब कुछ वही है जो action आपके लिए करता है। यह mcpsnoop इंस्टॉल करता है, कैप्चर की जाँच करता है, निष्कर्षों को Security टैब में दर्ज करता है, और जिस पर आपने गेट लगाया है उस पर जॉब को विफल कर देता है। ```yaml permissions: security-events: write contents: read steps: - uses: kerlenton/[email protected] with: session: artifacts/session.jsonl ``` एक रिलीज़ पिन करें, जो भी आप चाहें। सबसे नई [releases page](https://github.com/kerlenton/mcpsnoop/releases) पर है। जानबूझकर कोई फ़्लोटिंग `v1` नहीं है। पिन की गई रिलीज़ वही बाइनरी है जो action इंस्टॉल करता है, इसलिए दोनों कभी असहमत नहीं हो सकते और पुराना होने के लिए कोई डिफ़ॉल्ट संस्करण नहीं है। | Input | | |---|---| | `session` | जाँचने के लिए `.jsonl` कैप्चर, या उनकी एक डायरेक्टरी, रिपॉज़िटरी रूट के सापेक्ष। इसे या `replay` दें | | `replay` | `server` या `target` के विरुद्ध रीप्ले करने के लिए एक कमिट की गई रिकॉर्डिंग, जिसका कैप्चर फिर जाँचा जाता है और रिग्रेशन पर जॉब भी विफल होती है | | `server` | वह कमांड जो परीक्षणाधीन सर्वर शुरू करता है, कमांड लाइन की तरह उद्धृत। stdio सर्वर के लिए `replay` के साथ आवश्यक। `target` के साथ यह पहले एक HTTP सर्वर शुरू करता है, और जब एक पहले से चल रहा हो तो इसे छोड़ा जा सकता है | | `target` | रीप्ले करने के लिए Streamable HTTP एंडपॉइंट, जैसे `http://localhost:3000/mcp`। क्रेडेंशियल `replay-args` में `--header` के रूप में जाता है, और स्टेप लॉग उसका मान छिपाकर दिखाता है | | `replay-args` | कोई अन्य `replay` फ़्लैग, जैसे `--read-only`। `--out` अस्वीकार किया जाता है, क्योंकि कैप्चर कहाँ जाएगा यह action तय करता है | | `fail-on` | `--fail-on` की तरह, डिफ़ॉल्ट वही जो CLI का डिफ़ॉल्ट है | | `args` | कोई अन्य `check` फ़्लैग, कमांड लाइन की तरह उद्धृत। `--format` अस्वीकार किया जाता है, क्योंकि रिपोर्ट action पढ़ता है | | `upload-sarif` | रिपोर्ट को code scanning पर भेजें। `true` | | `category` | code scanning नेमस्पेस। `mcpsnoop`। मैट्रिक्स के प्रत्येक लेग के लिए इसे अलग रखें, वरना लेग एक-दूसरे को ओवरराइट कर देंगे | | `fail-on-findings` | किसी फाइंडिंग पर जॉब विफल करें। `true`। अलर्ट दर्ज करने और code scanning के आवश्यक चेक को निर्णय लेने देने के लिए `false` सेट करें | | `version` | कौन-सा mcpsnoop इंस्टॉल करना है। डिफ़ॉल्ट वही रिलीज़ जो आपने पिन की | | `install` | `false` जब mcpsnoop पहले से PATH पर हो, जो उस प्लेटफ़ॉर्म पर रास्ता है जिसके लिए कोई रिलीज़ नहीं बनाई जाती | आउटपुट हैं `outcome`, `sarif`, `exit-code` और `capture`, जो जाँचे गए कैप्चर का पथ है, जो `replay` के साथ वही है जो रीप्ले ने लिखा और जिसे आर्टिफ़ैक्ट के रूप में रखना उपयोगी है। `outcome` है `passed`, `findings`, या `error`, और तीसरे को अलग से संभालना उपयोगी है। इसका अर्थ है कि कुछ भी जाँचा नहीं गया, जो कुछ न मिलने के समान नहीं है। **जो रन जाँच नहीं कर सका वह जॉब विफल करता है, चाहे `fail-on-findings` कुछ भी कहे**, क्योंकि कुछ भी सत्यापित किए बिना हरी हो जाने वाली पाइपलाइन विफल होने वाली से बदतर है। जॉब को `security-events: write` चाहिए, वरना अपलोड 403 लौटाता है। code scanning के बिना किसी रिपॉज़िटरी में `upload-sarif: false` सेट करें। action के बिना वही जाँच चलाना, जिन संकेतों पर यह विफल हो सकता है और एग्ज़िट कोड [docs/CI.md](https://github.com/kerlenton/mcpsnoop/blob/main/docs/CI.md) में हैं। ## Documentation | Page | What is in it | |---|---| | [Checking sessions in CI](https://github.com/kerlenton/mcpsnoop/blob/main/docs/CI.md) | हर बिल्ड के विरुद्ध रिकॉर्डिंग रीप्ले करना, हर वह संकेत जिस पर `check` विफल हो सकता है, एग्ज़िट कोड, assertions, JUnit और SARIF रिपोर्ट, दो सेशन की तुलना, और action के बिना इसे जोड़ना | | [OpenTelemetry and Prometheus](https://github.com/kerlenton/mcpsnoop/blob/main/docs/OPENTELEMETRY.md) | स्पैन और वे क्या ले जाते हैं, उन्हें कलेक्टर तक स्ट्रीम करना, और लाइव टूल मेट्रिक्स | --- [Read more](https://github.com/kerlenton/mcpsnoop)
