Skip to content
KitploitKITPLOIT
HerramientasExploitsBlog
Log in
Enviar
HerramientasExploitsBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

FeedsContactoPrivacidad© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
inspector — 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. | Kitploit
Herramientas/GitHubGitHub/modelcontextprotocol/inspector
Scripting y AutomatizaciónDepuradoresUtilidades y FrameworksAutenticaciónSeguridad de IATop en Seguridad de IA #12
GitHub
modelcontextprotocol/inspector

inspector

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.

Ver RepositorioSitio web
11.3k1.6k155hace 19h 51mRevisado por Kitploit
Compartir
# 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.
Descargar herramienta

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

Sin datos de popularidad aún.

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →