Untersuchen, debuggen und visuell testen Sie Model Context Protocol (MCP)-Server über eine Web-UI, CLI oder TUI, mit Tool-/Ressourcen-Exploration, Anfrageprotokollierung und OAuth-Unterstützung.
Ein Entwicklerwerkzeug zum Inspizieren von Model Context Protocol (MCP)-Servern. Es wird als einzelnes Paket @modelcontextprotocol/inspector ausgeliefert, das vier Möglichkeiten zur Inspektion eines Servers bietet:
clients/mcpdo.Die ersten drei laufen über eine einzige globale mcp-inspector-Binärdatei; mcpdo ist eine zweite Binärdatei im selben Paket:
npx @modelcontextprotocol/inspector # web UI (default)
npx @modelcontextprotocol/inspector --cli # CLI
npx @modelcontextprotocol/inspector --tui # TUI
npx -p @modelcontextprotocol/inspector mcpdo --help # mcpdo
[!WARNING] Der Inspector verwaltet Secrets — OAuth-Tokens, OAuth-Client-Secrets und stdio-
env:-Werte — und speichert sie standardmäßig im Schlüsselbund des Betriebssystems, sofern verfügbar. Auf einem Rechner ohne Schlüsselbund — Linux ohne libsecret oder einen Secret Service, Headless- und SSH-Sitzungen, Termux und Container mit einem eingebundenen Volume — werden sie stattdessen in~/.mcp-inspector/secrets.jsongespeichert, unverschlüsselt, sofern Sie keinen Schlüssel bereitstellen. Siehe Wo Secrets gespeichert werden für Informationen dazu, wie Sie einen Schlüsselbund zurückerhalten, die Datei verschlüsseln oder Secrets nur im Speicher halten.
Upgrade von v1? Lesen Sie den Migrationsleitfaden v1 → v2 — CLI-Flags, die neue Aufteilung
--configvs.--catalog, die Anhebung der Node-Engine und was nicht mehr ausgeliefert wird.
Repo-Status. Dies ist die v2-Linie des Inspectors. Die aktive Entwicklung findet auf
v2/mainstatt (dem Develop-Branch — alle v2-PRs zielen darauf ab), der bei Meilenstein-Releases inmaingemergt wird;mainist der Standard-Branch und enthält die neueste veröffentlichte v2, die unter dem npm-Taglatestveröffentlicht wird. Die Legacy-v1-Linie lebt aufv1/main— nur Sicherheitsfixes, direkt von diesem Branch unter dem npm-Tagv1-latestveröffentlicht (npx @modelcontextprotocol/inspector@v1-latest). SieheAGENTS.mdfür Branch-/Board-Konventionen.
Erfordert Node ^22.23.4 || ^24.22.1 || >=26.12.1: die gepatchte Version auf jeder unterstützten Linie.
npm install # at the repo root; postinstall cascades into every client
npm run build # web → cli → tui → launcher
Für die tägliche Web-Iteration führen Sie Vite direkt aus — schnelles HMR, kein Launcher-Build erforderlich:
cd clients/web && npm run dev
Die launcher-gesteuerten Skripte führen den gebauten Launcher aus, also zuerst bauen:
npm run web # prod web launcher against clients/web/dist
npm run web:dev # web launcher in --dev mode (Vite)
v2 ist kein npm-Workspace — jeder Client unter clients/* behält seine eigene package.json und node_modules, und gemeinsam genutzter Code liegt in core/, der über einen Build-Zeit-Alias @inspector/core eingebunden wird. Jede Laufzeitabhängigkeit, die core/ importiert, wird einmal in der package.json im Repo-Root deklariert, und jeder Client deklariert nur das, was dieser Client allein nutzt — seinen UI-Stack, seine vom Bundler eingebundenen Pakete, seine Dev-Tooling — wodurch clients/cli und clients/launcher ohne eigene Laufzeitabhängigkeiten bleiben. Was das für das Hinzufügen einer Abhängigkeit bedeutet (Root vs. Client, dependencies vs. devDependencies und die external-Listen des Bundlers), steht in der 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
Jeder Client hat eine eigene README mit client-spezifischen Details: web · cli · mcpdo · tui · launcher.