افحص خوادم بروتوكول سياق النموذج (MCP) وصحّح أخطاءها واختبرها بصريًا من واجهة ويب أو CLI أو TUI، مع استكشاف الأدوات والموارد، وتسجيل الطلبات، ودعم 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، وقيم
env:الخاصة بـ stdio — ويخزّنها في سلسلة مفاتيح نظام التشغيل، إن كانت متاحة، افتراضيًا. على جهاز لا توجد فيه سلسلة مفاتيح — Linux بدون libsecret أو Secret Service، وجلسات headless وSSH، وTermux، والحاويات ذات وحدة تخزين مُثبَّتة — تُحفظ بدلًا من ذلك في~/.mcp-inspector/secrets.json، غير مشفّرة ما لم توفّر مفتاحًا. راجع أين تُخزَّن الأسرار لمعرفة كيفية استعادة سلسلة مفاتيح، أو تشفير الملف، أو إبقاء الأسرار في الذاكرة فقط.
هل تُرقّي من v1؟ اقرأ دليل الترقية من v1 إلى v2 — أعلام CLI، والفصل الجديد بين
--configو--catalog، وترقية محرك Node، وما لم يعد يُشحن.
حالة المستودع. هذا هو خط v2 من Inspector. يجري التطوير النشط على
v2/main(فرع التطوير — جميع طلبات السحب الخاصة بـ v2 تستهدفه)، والذي يُدمج فيmainعند إصدارات المعالم؛ وmainهو الفرع الافتراضي ويحمل أحدث إصدار v2 صادر، منشورًا على وسمlatestفي npm. يعيش خط v1 القديم علىv1/main— إصلاحات أمنية فقط، تُنشر مباشرة من ذلك الفرع إلى وسمv1-latestفي npm (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 — يحتفظ كل عميل ضمن clients/* بملف package.json ومجلد node_modules الخاص به، ويعيش الكود المشترك في core/، ويُستهلك عبر alias وقت البناء @inspector/core. كل تبعية وقت تشغيل يستوردها core/ تُعلَن مرة واحدة، في package.json الجذر للمستودع، ويعلن كل عميل فقط ما يستهلكه ذلك العميل وحده — حزمة واجهة المستخدم الخاصة به، وحزمه المضمَّنة في المُجمِّع، وأدوات التطوير الخاصة به — مما يترك clients/cli وclients/launcher بلا تبعيات وقت تشغيل خاصة بهما. وما يعنيه ذلك عند إضافة تبعية (الجذر مقابل العميل، وdependencies مقابل devDependencies، وقوائم external في المُجمِّع) موجود في مهارة local-dev.
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.