वेब UI, CLI या TUI से Model Context Protocol (MCP) सर्वरों का निरीक्षण, डिबग और दृश्य रूप से परीक्षण करें, जिसमें टूल/संसाधन अन्वेषण, अनुरोध लॉगिंग और OAuth समर्थन शामिल है।
Model Context Protocol (MCP) सर्वर का निरीक्षण करने के लिए एक डेवलपर टूल। यह एक ही पैकेज, @modelcontextprotocol/inspector, के रूप में आता है, जो किसी सर्वर का निरीक्षण करने के चार तरीके प्रदान करता है:
clients/mcpdo।पहले तीन एक ही ग्लोबल mcp-inspector बाइनरी के माध्यम से चलते हैं; mcpdo उसी पैकेज में एक दूसरी बाइनरी है:
npx @modelcontextprotocol/inspector # web UI (default)
npx @modelcontextprotocol/inspector --cli # CLI
npx @modelcontextprotocol/inspector --tui # TUI
npx -p @modelcontextprotocol/inspector mcpdo --help # mcpdo
[!WARNING] Inspector गोपनीय जानकारी — OAuth टोकन, OAuth क्लाइंट सीक्रेट, और stdio
env:मान — का प्रबंधन करता है और डिफ़ॉल्ट रूप से, यदि उपलब्ध हो, तो उन्हें OS कीचेन में संग्रहीत करता है। ऐसी मशीन पर जिसमें कोई कीचेन नहीं है — libsecret या Secret Service के बिना Linux, हेडलेस और SSH सत्र, Termux, और माउंट किए गए वॉल्यूम वाले कंटेनर — उन्हें इसके बजाय~/.mcp-inspector/secrets.jsonमें सहेजा जाता है, जो तब तक अनएन्क्रिप्टेड रहता है जब तक आप कोई कुंजी प्रदान नहीं करते। कीचेन वापस पाने, फ़ाइल को एन्क्रिप्ट करने, या गोपनीय जानकारी केवल मेमोरी में रखने के तरीके के लिए गोपनीय जानकारी कहाँ संग्रहीत होती है देखें।
v1 से अपग्रेड कर रहे हैं? v1 → v2 माइग्रेशन गाइड पढ़ें — CLI फ़्लैग, नया
--configबनाम--catalogविभाजन, Node इंजन में वृद्धि, और अब क्या शामिल नहीं होता।
रेपो स्थिति। यह Inspector की v2 श्रृंखला है। सक्रिय विकास
v2/mainपर होता है (डेवलप ब्रांच — सभी v2 PR इसी को लक्षित करते हैं), जिसे माइलस्टोन रिलीज़ परmainमें मर्ज किया जाता है;mainडिफ़ॉल्ट ब्रांच है और इसमें नवीनतम रिलीज़ किया गया v2 होता है, जो npmlatestटैग पर प्रकाशित होता है। लेगेसी v1 श्रृंखलाv1/mainपर रहती है — केवल सुरक्षा फ़िक्स, सीधे उसी ब्रांच से npmv1-latestटैग पर प्रकाशित (npx @modelcontextprotocol/inspector@v1-latest)। ब्रांच/बोर्ड परंपराओं के लिएAGENTS.mdदेखें।
Node ^22.23.4 || ^24.22.1 || >=26.12.1 आवश्यक है: प्रत्येक समर्थित श्रृंखला पर पैच किया गया रिलीज़।
npm install # at the repo root; postinstall cascades into every client
npm run build # web → cli → tui → launcher
दैनिक वेब पुनरावृत्ति के लिए, Vite को सीधे चलाएँ — तेज़ HMR, किसी लॉन्चर बिल्ड की आवश्यकता नहीं:
cd clients/web && npm run dev
लॉन्चर-संचालित स्क्रिप्ट्स बिल्ट लॉन्चर चलाती हैं, इसलिए पहले बिल्ड करें:
npm run web # prod web launcher against clients/web/dist
npm run web:dev # web launcher in --dev mode (Vite)
v2 npm workspace नहीं है — clients/* के अंतर्गत प्रत्येक क्लाइंट अपना स्वयं का package.json और node_modules रखता है, और साझा कोड core/ में रहता है, जिसे @inspector/core बिल्ड-टाइम alias के माध्यम से उपभोग किया जाता है। core/ द्वारा आयात की जाने वाली प्रत्येक रनटाइम निर्भरता एक बार, रेपो-रूट package.json में घोषित की जाती है, और प्रत्येक क्लाइंट केवल वही घोषित करता है जो केवल वही क्लाइंट उपभोग करता है — उसका UI स्टैक, उसके bundler-inlined पैकेज, उसके dev टूलिंग — जिससे clients/cli और clients/launcher के पास अपनी कोई रनटाइम निर्भरता नहीं बचती। निर्भरता जोड़ने (root बनाम client, dependencies बनाम devDependencies, और bundler external सूचियाँ) के लिए इसका क्या अर्थ है, यह local-dev skill में है।
inspector/
├── clients/
│ ├── web/ Web client (Vite + React + Mantine). src/ = browser app; server/ = Node backend
│ ├── cli/ CLI client (tsdown bundle, @inspector/core alias)
│ ├── mcpdo/ Experimental connection CLI (`mcpdo` bin) — bundled into the
│ │ published package; see clients/mcpdo/README.md
│ ├── tui/ TUI client (Ink + React, tsdown bundle)
│ └── launcher/ Shared launcher — provides the `mcp-inspector` bin, dispatches to web/cli/tui
├── core/ Shared code consumed via the `@inspector/core` alias (no package.json)
├── test-servers/ Composable MCP test servers + fixtures used by integration and smoke tests
├── scripts/ Root build/verify tooling (install cascade, smokes, the verify:* guards),
│ repo automation run from CI (the dependency, Dependabot-alert and SDK sweeps),
│ maintainer-workflow helpers (the pr:*, board:*, advisory:*,
│ release:notes, release:tag and action:resolve-pin aliases)
│ and the Docker image's HEALTHCHECK probe
├── docs/ Task-oriented guides — see below
├── specification/ Design/build specifications
├── skills/ End-user agent skills (e.g. skills/mcpdo teaches an agent to
│ drive the `mcpdo` CLI) — distinct from .claude/skills/,
│ which holds this repo's own procedures
├── .claude/skills/ Agent skills: the repo's procedures, invokable by name
├── AGENTS.md Contribution rules for agents AND humans
└── README.md You are here
प्रत्येक क्लाइंट का अपना README है जिसमें क्लाइंट-विशिष्ट विवरण दिया गया है: web · cli · mcpdo · tui · launcher।