
Web UI、CLI、またはTUIからModel Context Protocol (MCP)サーバーを検査、デバッグ、視覚的にテストできます。ツール/リソースの探索、リクエストログ記録、OAuthサポートを備えています。
Model Context Protocol(MCP)サーバーを検査するための開発者向けツールです。単一のパッケージ @modelcontextprotocol/inspector として提供され、サーバーを検査する4つの方法を備えています:
clients/mcpdo を参照してください。最初の3つは単一のグローバル mcp-inspector バイナリを通じて実行されます。mcpdo は同じパッケージ内の2つ目のバイナリです:
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 を保持し、npm のlatestタグに公開されます。レガシーの v1 ラインはv1/mainに存在します — セキュリティ修正のみで、そのブランチから直接 npm のv1-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
日常的な web のイテレーションでは、Vite を直接実行してください。高速な HMR が利用でき、ランチャーのビルドは不要です:
cd clients/web && npm run dev
The launcher-driven scripts run the built launcher, so build first:
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/ に置かれ、@inspector/core のビルド時エイリアス経由で利用されます。core/ がインポートするすべてのランタイム依存関係は、リポジトリルートの package.json で一度だけ宣言され、各クライアントはそのクライアントだけが消費するもの — UI スタック、バンドラーにインライン化されるパッケージ、開発ツール — のみを宣言します。その結果、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。