Repolode
modelcontextprotocol

modelcontextprotocol/inspector

Herramienta visual y de línea de comandos para probar y depurar servidores Model Context Protocol (MCP), con modos web, CLI e interfaz de terminal.

Estrellas
11,119
Forks
1,545
Issues abiertos
26
Último commit
hace 13 horas

¿Qué es?

MCP Inspector permite a los desarrolladores conectarse a servidores Model Context Protocol e inspeccionar lo que ofrecen, como herramientas, recursos y prompts, además de invocarlos directamente para comprobar su comportamiento. Se distribuye como un único paquete, @modelcontextprotocol/inspector, que incluye un binario mcp-inspector con una interfaz web (la opción predeterminada), una CLI programable y una interfaz de terminal interactiva.

La interfaz web es una aplicación de una sola página creada con Vite y React, con un backend de Node y construida con Mantine. La CLI está diseñada para la automatización y CI, de modo que permite probar un servidor mediante una prueba rápida que se conecta, enumera, invoca y verifica resultados; además, ofrece una salida JSON compatible con herramientas como jq. La TUI usa Ink para ofrecer una experiencia interactiva en la terminal.

El paquete también incluye el binario experimental mcpdo, una CLI de conexión que se conecta una vez a un servidor con nombre y ejecuta muchos comandos a través de un daemon local. Los secretos, como los tokens OAuth y los valores de entorno de stdio, se guardan en el llavero del sistema operativo cuando está disponible; si no, se usa un archivo como alternativa.

Funciones clave

  • 01Interfaz web para explorar e invocar herramientas, recursos y prompts de servidores MCP
  • 02CLI programable para automatización, CI y pruebas rápidas, con salida JSON
  • 03Interfaz de terminal interactiva creada con Ink
  • 04Guarda tokens OAuth y secretos en el llavero del sistema operativo cuando está disponible
  • 05CLI de conexión experimental mcpdo que reutiliza una conexión para varios comandos

Casos de uso

  • Depurar un servidor MCP personalizado durante el desarrollo, antes de conectarlo a un cliente de IA
  • Ejecutar comprobaciones de conexión, enumeración, invocación y verificación en un servidor MCP mediante CI
  • Probar servidores MCP protegidos con OAuth de forma interactiva o no interactiva
  • Explorar las herramientas disponibles en un servidor MCP desconocido y sus parámetros de entrada

Inicio rápido

  1. 1

    Ejecuta la interfaz web con npx (no hace falta instalar nada)

    npx @modelcontextprotocol/inspector
  2. 2

    O ejecuta el cliente de línea de comandos

    npx @modelcontextprotocol/inspector --cli

Antes de usarlo

  • La licencia figura como NOASSERTION y el README describe una transición de licencia que combina MIT y Apache-2.0, así que consulta LICENSE antes de reutilizarlo.
  • En máquinas sin un llavero del sistema operativo, los secretos, como los tokens OAuth, se guardan sin cifrar en ~/.mcp-inspector/secrets.json, a menos que proporciones una clave.
  • El desarrollo requiere Node 22.19.0 o posterior.

Temas

Preguntas frecuentes

¿Qué es inspector?
Herramienta visual y de línea de comandos para probar y depurar servidores Model Context Protocol (MCP), con modos web, CLI e interfaz de terminal. MCP Inspector permite a los desarrolladores conectarse a servidores Model Context Protocol e inspeccionar lo que ofrecen, como herramientas, recursos y prompts, además de invocarlos directamente para comprobar su comportamiento. Se distribuye como un único paquete, @modelcontextprotocol/inspector, que incluye un binario mcp-inspector con una interfaz web (la opción predeterminada), una CLI programable y una interfaz de terminal interactiva.
¿inspector es gratuito? ¿Qué licencia tiene?
inspector es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿inspector sigue mantenido?
Mantenimiento activo. El último commit de inspector fue el 21 oct 2026.
¿Para qué puedo usar inspector?
Depurar un servidor MCP personalizado durante el desarrollo, antes de conectarlo a un cliente de IA Ejecutar comprobaciones de conexión, enumeración, invocación y verificación en un servidor MCP mediante CI Probar servidores MCP protegidos con OAuth de forma interactiva o no interactiva Explorar las herramientas disponibles en un servidor MCP desconocido y sus parámetros de entrada
¿Cómo se instala inspector?
Ejecuta la interfaz web con npx (no hace falta instalar nada): npx @modelcontextprotocol/inspector O ejecuta el cliente de línea de comandos: npx @modelcontextprotocol/inspector --cli
¿Dónde consigo inspector?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/modelcontextprotocol/inspector

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados