
웹 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 워크스페이스가 아닙니다 — clients/* 아래의 각 클라이언트는 자체 package.json과 node_modules를 유지하며, 공유 코드는 core/에 위치하고 @inspector/core 빌드 시점 별칭을 통해 사용됩니다. core/가 임포트하는 모든 런타임 의존성은 저장소 루트의 package.json에 한 번만 선언되며, 각 클라이언트는 해당 클라이언트만 소비하는 것 — 즉 UI 스택, 번들러에 인라인되는 패키지, 개발 도구 — 만 선언하므로 clients/cli와 clients/launcher에는 자체 런타임 의존성이 없습니다. 의존성을 추가할 때(루트 vs. 클라이언트, dependencies vs. 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.