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.
# MCP Inspector Una herramienta para desarrolladores que permite inspeccionar servidores del [Model Context Protocol](https://modelcontextprotocol.io) (MCP). Se distribuye como un único paquete, `@modelcontextprotocol/inspector`, que ofrece cuatro formas de inspeccionar un servidor: - **Web** — una aplicación de página única con Vite + React + [Mantine](https://mantine.dev) y un backend en Node. - **CLI** — un cliente de línea de comandos programable para automatización, CI y ciclos de retroalimentación rápidos para agentes. - **TUI** — una interfaz de terminal interactiva construida con [Ink](https://github.com/vadimdemedes/ink). - **mcpdo** _(experimental)_ — una CLI de conexión: conéctate una vez y luego ejecuta muchos comandos contra la conexión nombrada a través de un daemon local implícito. Consulta [`clients/mcpdo`](https://github.com/modelcontextprotocol/inspector/blob/main/clients/mcpdo/README.md). Los tres primeros se ejecutan mediante un único binario global `mcp-inspector`; `mcpdo` es un segundo binario dentro del mismo paquete: ```bash 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.json` en su lugar, sin cifrar a menos que proporciones una clave. Consulta [Dónde se almacenan los secretos](https://github.com/modelcontextprotocol/inspector/blob/main/docs/secret-storage.md) 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](https://github.com/modelcontextprotocol/inspector/blob/main/docs/v1-to-v2-migration.md): las flags de la CLI, la nueva división entre `--config` y `--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 en **`main`** en las versiones de hito; `main` es la rama predeterminada y contiene la última v2 publicada, publicada en la etiqueta `latest` de npm. La línea heredada **v1** vive en **`v1/main`** —solo correcciones de seguridad, publicadas directamente desde esa rama a la etiqueta `v1-latest` de npm (`npx @modelcontextprotocol/inspector@v1-latest`). Consulta [`AGENTS.md`](https://github.com/modelcontextprotocol/inspector/blob/main/AGENTS.md) para las convenciones de ramas y tableros. ## Inicio rápido (desarrollo) Requiere Node `^22.23.4 || ^24.22.1 || >=26.12.1`: la versión parcheada de cada línea compatible. ```bash 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: ```bash cd clients/web && npm run dev ``` Los scripts impulsados por el launcher ejecutan el launcher **compilado**, así que compila primero: ```bash 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`](https://github.com/modelcontextprotocol/inspector/blob/main/.claude/skills/local-dev/SKILL.md). ## Estructura del proyecto ``` 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](https://github.com/modelcontextprotocol/inspector/blob/main/clients/web/README.md) · [cli](https://github.com/modelcontextprotocol/inspector/blob/main/clients/cli/README.md) · [mcpdo](https://github.com/modelcontextprotocol/inspector/blob/main/clients/mcpdo/README.md) · [tui](https://github.com/modelcontextprotocol/inspector/blob/main/clients/tui/README.md) · [launcher](https://github.com/modelcontextprotocol/inspector/blob/main/clients/launcher/README.md). ## Documentación | Guía | Cubre | | --- | --- | | [Arquitectura](https://github.com/modelcontextprotocol/inspector/blob/main/docs/architecture.md) | El paquete compartido `@inspector/core`, y el enfoque de "componentes tontos" + Storybook del cliente web | | [Pruebas y la puerta de calidad](https://github.com/modelcontextprotocol/inspector/blob/main/docs/quality-gate.md) | Qué cubre cada script `validate` / `coverage` / `smoke` / `verify:*`, la división entre la puerta de GitHub-CI y la local, y los navegadores compatibles | | [Escribir una skill](https://github.com/modelcontextprotocol/inspector/blob/main/docs/skill-authoring.md) | Cómo escribir una descripción de skill que realmente se active, y casos de evaluación que lo midan — las formas de caso que funcionan, y el bucle de ajuste | | [Servidores de prueba](https://github.com/modelcontextprotocol/inspector/blob/main/docs/test-servers.md) | Los servidores de prueba componibles y la configuración de demostración para cada funcionalidad — qué ejecutar, qué hacer clic, y qué hizo la compilación rota | | [Publicación](https://github.com/modelcontextprotocol/inspector/blob/main/docs/publishing.md) | Qué se incluye en el tarball, las invariantes de empaquetado, y `pack:verify` | | [Migrar de tsup a tsdown](https://github.com/modelcontextprotocol/inspector/blob/main/docs/tsdown-migration.md) | Por qué los bundles de los clientes se movieron a tsdown, el mapeo de opciones, las trampas que no hacen fallar una compilación, y qué midió la migración de cada cliente | | [Servir la interfaz web sobre HTTPS](https://github.com/modelcontextprotocol/inspector/blob/main/docs/tls.md) | `INSPECTOR_TLS_KEY_PATH` / `INSPECTOR_TLS_CERT_PATH`, una configuración local de mkcert de confianza, nombres de host personalizados y `ALLOWED_ORIGINS`, y `NODE_EXTRA_CA_CERTS` para servidores salientes con CA privada | | [Docker](https://github.com/modelcontextprotocol/inspector/blob/main/docs/docker.md) | Ejecutar la imagen del contenedor — puertos, volúmenes, y hacer duraderos los secretos en un contenedor | | [Dónde se almacenan los secretos](https://github.com/modelcontextprotocol/inspector/blob/main/docs/secret-storage.md) | Cómo se elige el almacén de secretos en cada entorno de ejecución — llavero del SO, `secrets.json` o memoria — además del cifrado de archivos, el bloqueo, y volver a un llavero | | [Migrar de v1 a v2](https://github.com/modelcontextprotocol/inspector/blob/main/docs/v1-to-v2-migration.md) | Mapeo de flags de la CLI, `--config` vs. `--catalog`, el aumento de la versión de Node, renombrados de variables de entorno | | [Variables de entorno](https://github.com/modelcontextprotocol/inspector/blob/main/docs/environment-variables.md) | Cada variable que cambia el comportamiento en tiempo de ejecución — autenticación, puertos, almacenamiento, el almacén de secretos, registro, proxies — además de las variables TLS de Node para un servidor autofirmado | | [Configuración del servidor MCP](https://github.com/modelcontextprotocol/inspector/blob/main/docs/mcp-server-configuration.md) | A qué servidor(es) se conecta el Inspector, y el formato del archivo de configuración | | [Revisar una MCP App](https://github.com/modelcontextprotocol/inspector/blob/main/docs/mcp-app-review.md) | La receta CLI-primero → web de un solo paso para la revisión automatizada de herramientas de App | | [Pruebas de humo de un servidor MCP](https://github.com/modelcontextprotocol/inspector/blob/main/docs/cli-smoke-testing.md) | El flujo de trabajo conectar → listar → llamar → verificar para un trabajo de shell o CI: `--format json` + `jq`, el mapa de códigos de salida, y mantener OAuth no interactivo | | [Firmas DCO retroactivas](https://github.com/modelcontextprotocol/inspector/blob/main/docs/dco-retroactive-signoffs.md) | Los diez commits que se fusionaron sin un `Signed-off-by:` mientras no se ejecutaba ninguna comprobación de DCO, y la certificación firmada de cada autor sobre ellos | | [Consolidación del launcher y la configuración](https://github.com/modelcontextprotocol/inspector/blob/main/docs/launcher-config-consolidation-plan.md) | Por qué el launcher ejecuta un cliente en proceso en lugar de lanzarlo como subproceso | | [Hoja de ruta, ago 2026 → feb 2027](https://github.com/modelcontextprotocol/inspector/blob/main/docs/inspector-roadmap-2026-h2.md) | El plan de seis meses: trabajo de seguimiento de especificaciones alineado con la hoja de ruta publicada de MCP, soporte oficial de extensiones, y el trabajo de experiencia que elegimos | | [MCP Inspector: Nuestra fábrica de software con IA](https://github.com/modelcontextprotocol/inspector/blob/main/docs/ai-software-factory.md) | Cómo ocurren realmente las contribuciones desde la v2.0.0 — trabajo impulsado por issues de principio a fin, la división reglas/skills, los barridos que reemplazaron a Dependabot, la puerta de calidad, y hacia dónde se dirige | ## Pruebas y la puerta de calidad Cada cliente se autovalida desde su propia carpeta; los scripts raíz los encadenan. **No** existe un script `test` agregado en la raíz. ```bash npm run validate # fast inner loop: format:check + lint + typecheck + build + unit tests npm run coverage # the per-file ≥90% gate (lines/statements/functions/branches) npm run local:gate # MANDATORY before pushing — every GitHub CI check, plus one local-only one ``` `npm run local:gate` encadena todas las comprobaciones siguientes, además de los smokes y las pruebas de Storybook. [Testing and the quality gate](https://github.com/modelcontextprotocol/inspector/blob/main/docs/quality-gate.md) es el documento que define la lista de etapas y explica qué cubre cada una y por qué una es solo local; [`AGENTS.md`](https://github.com/modelcontextprotocol/inspector/blob/main/AGENTS.md) contiene las propias reglas de testing. ## Contribuir — `AGENTS.md`, `CLAUDE.md` y las skills **[`AGENTS.md`](https://github.com/modelcontextprotocol/inspector/blob/main/AGENTS.md) es el contrato para modificar este código base, y se aplica tanto a personas como a agentes de IA.** No es texto de plantilla exclusivo para agentes: contiene las **reglas** reales del proyecto: las convenciones de versión/etiqueta, los estándares de TypeScript y Mantine/React, los requisitos de testing y cobertura, y la puerta obligatoria previa al push. Léelo antes de hacer cambios y mantenlo actualizado cuando modifiques la estructura, las herramientas o las reglas. Los **procedimientos** del repositorio —recetas de varios pasos con comandos e IDs en vivo— viven en [`.claude/skills/`](https://github.com/modelcontextprotocol/inspector/blob/main/.claude/skills), un directorio por procedimiento, de modo que solo se cargan cuando la tarea lo requiere. Son Markdown normal versionado: un agente que no entienda de skills puede leerlos, y `AGENTS.md` incluye un índice de lo que existe. Los usuarios de Claude Code invocan uno por su nombre (`/release`, `/issue-triage`, …). `CLAUDE.md` es el punto de entrada que [Claude Code](https://claude.com/claude-code) carga automáticamente; incluye `AGENTS.md`, de modo que agentes y personas trabajan desde la misma fuente de verdad. Si usas otro agente que lea `AGENTS.md`, obtienes las mismas reglas. Una regla clave que conviene destacar aquí: **todo el trabajo se gestiona mediante issues.** Antes de empezar, busca o crea un issue de seguimiento en el tablero del proyecto v2; abre PRs contra `v2/main` con `Closes #<issue>`. Las contribuciones externas se aceptan como **issues, no como pull requests** — consulta [`CONTRIBUTING.md`](https://github.com/modelcontextprotocol/inspector/blob/main/CONTRIBUTING.md). ## Licencia Consulta [`LICENSE`](https://github.com/modelcontextprotocol/inspector/blob/main/LICENSE). El proyecto MCP está en transición de la Licencia MIT a Apache-2.0: las nuevas contribuciones de código se licencian bajo Apache-2.0, la documentación (excluyendo las especificaciones) bajo CC-BY-4.0, y las contribuciones cuyos autores las licenciaron originalmente bajo MIT y no han otorgado consentimiento para la relicencia permanecen bajo MIT. El archivo contiene los textos completos de Apache-2.0 y MIT y enlaza al código legal de CC-BY-4.0.
Descubre las herramientas más usadas por nuestra comunidad.
Sin datos de popularidad aún.