Inspecciona, depura y prueba visualmente servidores del Model Context Protocol (MCP) desde una interfaz web, CLI o TUI, con exploración de herramientas/recursos, registro de solicitudes y soporte de OAuth.
Una herramienta para desarrolladores que permite inspeccionar servidores del Model Context Protocol (MCP). Se distribuye como un único paquete, @modelcontextprotocol/inspector, que ofrece cuatro formas de inspeccionar un servidor:
clients/mcpdo.Los tres primeros se ejecutan mediante un único binario global mcp-inspector; mcpdo es un segundo binario dentro del mismo paquete:
npx @modelcontextprotocol/inspector # web UI (default)
npx @modelcontextprotocol/inspector --cli # CLI
npx @modelcontextprotocol/inspector --tui # TUI
npx -p @modelcontextprotocol/inspector mcpdo --help # mcpdo
[!WARNING] El Inspector gestiona secretos —tokens OAuth, secretos de cliente OAuth y valores
env:de stdio— y los almacena en el llavero del sistema operativo, si está disponible, de forma predeterminada. En una máquina sin llavero —Linux sin libsecret ni un Secret Service, sesiones sin interfaz gráfica y por SSH, Termux, y contenedores con un volumen montado— se guardan en~/.mcp-inspector/secrets.jsonen su lugar, sin cifrar a menos que proporciones una clave. Consulta Dónde se almacenan los secretos para saber cómo recuperar un llavero, cifrar el archivo o mantener los secretos solo en memoria.
¿Actualizando desde la v1? Lee la guía de migración de v1 → v2: las flags de la CLI, la nueva división entre
--configy--catalog, el aumento de la versión del motor de Node y lo que ya no se distribuye.
Estado del repositorio. Esta es la línea v2 del Inspector. El desarrollo activo ocurre en
v2/main(la rama de desarrollo —todas las PR de la v2 apuntan a ella), que se fusiona enmainen las versiones de hito;maines la rama predeterminada y contiene la última v2 publicada, publicada en la etiquetalatestde npm. La línea heredada v1 vive env1/main—solo correcciones de seguridad, publicadas directamente desde esa rama a la etiquetav1-latestde npm (npx @modelcontextprotocol/inspector@v1-latest). ConsultaAGENTS.mdpara las convenciones de ramas y tableros.
Requiere Node ^22.23.4 || ^24.22.1 || >=26.12.1: la versión parcheada de cada línea compatible.
npm install # at the repo root; postinstall cascades into every client
npm run build # web → cli → tui → launcher
Para la iteración web del día a día, ejecuta Vite directamente — HMR rápido, sin necesidad de compilar el lanzador:
cd clients/web && npm run dev
Los scripts impulsados por el launcher ejecutan el launcher compilado, así que compila primero:
npm run web # prod web launcher against clients/web/dist
npm run web:dev # web launcher in --dev mode (Vite)
v2 no es un workspace de npm — cada cliente bajo clients/* mantiene su propio package.json y node_modules, y el código compartido vive en core/, consumido mediante un alias de compilación @inspector/core. Toda dependencia de tiempo de ejecución que importa core/ se declara una sola vez, en el package.json de la raíz del repositorio, y cada cliente declara únicamente lo que ese cliente consume por sí solo — su stack de UI, sus paquetes inlineados por el bundler, sus herramientas de desarrollo — lo que deja a clients/cli y clients/launcher sin dependencias de tiempo de ejecución propias. Lo que eso implica para añadir una dependencia (raíz vs. cliente, dependencies vs. devDependencies, y las listas external del bundler) está en la skill 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
Cada cliente tiene su propio README con detalles específicos del cliente: web · cli · mcpdo · tui · launcher.