Инспектируйте, отлаживайте и визуально тестируйте серверы Model Context Protocol (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] Инспектор управляет секретами — OAuth-токенами, секретами OAuth-клиентов и значениями
env:для stdio — и по умолчанию хранит их в связке ключей ОС, если она доступна. На машине без связки ключей — Linux без libsecret или Secret Service, headless- и SSH-сессии, Termux, а также контейнеры с примонтированным томом — они вместо этого сохраняются в~/.mcp-inspector/secrets.jsonбез шифрования, если вы не предоставите ключ. См. Где хранятся секреты, чтобы узнать, как вернуть связку ключей, зашифровать файл или хранить секреты только в памяти.
Обновляетесь с v1? Прочитайте руководство по миграции с v1 на v2 — флаги CLI, новое разделение
--configи--catalog, повышение требований к движку Node и что больше не поставляется.
Статус репозитория. Это линия v2 Инспектора. Активная разработка ведётся в
v2/main(ветка разработки — все PR для v2 нацелены на неё), которая сливается в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
Для повседневной итерации по веб-интерфейсу запускайте 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. Каждая runtime-зависимость, импортируемая core/, объявляется один раз в корневом package.json репозитория, а каждый клиент объявляет только то, что потребляет исключительно он сам — свой UI-стек, свои пакеты, встраиваемые бандлером, свои dev-инструменты — благодаря чему clients/cli и clients/launcher остаются без собственных runtime-зависимостей. О том, что это означает для добавления зависимости (корень 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.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.