MCPJam Inspector (MCP server) — Casos de uso, Instalar & Demo en vivo

Name: MCPJam Inspector MCP Server
Author: MCPJam

Por qué usarlo

Características clave

Conecta cualquier transporte MCP: stdio / SSE / HTTP streamable
Llama manualmente cualquier herramienta con entradas guiadas por formulario y validación en vivo de JSON Schema
Chat integrado que usa las herramientas del servidor — observa cómo un LLM las utiliza realmente
Modo eval: ejecuta un prompt contra múltiples modelos y compara trazas de uso de herramientas
Funciona también para apps de ChatGPT, no solo servidores MCP

Demo en vivo

Cómo se ve en la práctica

mcpjam-inspector.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcpjam-inspector",
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcpjam-inspector": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mcpjam/inspector"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add mcpjam-inspector -- npx -y @mcpjam/inspector

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: MCPJam Inspector

Depurar por qué tu herramienta MCP se está llamando incorrectamente

👤 Autores de servidores MCP ⏱ ~20 min intermediate

Cuándo usarlo: Publicaste una herramienta y Claude sigue llamándola con argumentos incorrectos.

Requisitos previos

Inspector en ejecución — npx -y @mcpjam/inspector (abre el navegador en localhost:6274)
Tu servidor MCP — Tenlo listo para lanzar mediante comando stdio o URL SSE

Flujo

Conectar el servidor

In the inspector UI, add a stdio server: command=node, args=[./dist/server.js].✓ Copiado

→ La lista de herramientas aparece con descripciones + esquemas
Leer la vista del LLM

Look at the rendered description in the tool detail panel — that's exactly what the model sees.✓ Copiado

→ Identificas la ambigüedad («id» debería ser «task_id», o falta un ejemplo)
Reproducir el uso incorrecto

Open Chat tab. Send the user prompt that caused the failure. Watch the tool_use payload.✓ Copiado

→ La misma llamada incorrecta que viste en producción
Corregir la descripción y volver a probar

Update the tool's description and example in your server code, restart, retry the same prompt.✓ Copiado

→ Llamada correcta esta vez

Resultado: Corrección concreta respaldada por un antes/después basado en evidencia.

Errores comunes

Esquema obsoleto en caché después de reiniciar el servidor — Haz clic en «Reconnect» en el panel del servidor; el inspector vuelve a obtener list_tools

Evaluar cómo distintos modelos usan las herramientas de tu servidor MCP

👤 Autores de servidores orientados a múltiples clientes ⏱ ~45 min advanced

Cuándo usarlo: Quieres saber si tu servidor funciona igual de bien con Sonnet que con Haiku/GPT-5.

Flujo

Construir un conjunto de evaluación

Author 10 representative user prompts in the Eval tab. Mix easy and adversarial.✓ Copiado

→ Eval guardada con prompts + secuencias de herramientas esperadas
Ejecutar en varios modelos

Run the eval against Sonnet 4.6, Haiku 4.5, and GPT-5. Compare tool-use traces.✓ Copiado

→ Traza por modelo; aprobado/fallado por prompt
Refinar el esquema más débil

On the failing prompts, what description change would fix the cheaper model without breaking Sonnet?✓ Copiado

→ Reescritura concreta de la descripción

Resultado: Un servidor que funciona en toda la gama de modelos, no solo en el que probaste.

Errores comunes

La evaluación solo prueba el camino feliz — Añade prompts adversariales: argumentos faltantes, entradas contradictorias, información parcial

Explorar un servidor MCP de terceros desconocido de forma segura

👤 Cualquiera evaluando un MCP de la comunidad ⏱ ~15 min intermediate

Cuándo usarlo: Estás considerando agregar el MCP de alguien a tu configuración y quieres ver primero qué herramientas expone.

Flujo

Arrancarlo de forma aislada

Add the server in inspector — don't put it in your real client config yet.✓ Copiado

→ Herramientas listadas con descripciones completas
Auditar la superficie

Scan tool list. Anything that writes/deletes/runs code? Anything that calls external URLs?✓ Copiado

→ Lista de herramientas categorizada por riesgo
Probar manualmente las herramientas de riesgo

Hand-call each write tool with a no-op payload to see what it actually does.✓ Copiado

→ Confirmas el comportamiento antes de exponerlo a un agente autónomo

Resultado: Decisión informada de instalar/omitir en lugar de confianza ciega.

Errores comunes

La herramienta ejecuta un shell — incluso la llamada manual puede mutar tu sistema — Ejecuta en un contenedor o directorio de pruebas; nunca inspecciones un MCP no confiable en tu máquina de trabajo

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mcpjam-inspector + github

Perfilar tu propio servidor MCP en CI

On every PR, run inspector eval against the main + PR head; comment diff in the PR via github MCP.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_tools	server connection	Se ejecuta automáticamente al conectar — rara vez se llama manualmente	0
call_tool	tool_name, args	Llamar manualmente cualquier herramienta con entradas de formulario	depends on tool
chat	model, messages	Guiar a un LLM a través de tus herramientas para observar el comportamiento emergente	depends on model API
run_eval	eval_set, models[]	Verificación de regresión entre modelos antes de publicar	API calls × models × prompts

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: El modo eval consume las cuotas del proveedor LLM — trae tus propias claves
Tokens por llamada: 0 para el inspector en sí; coste completo de agente para chat/eval
Monetario: Gratuito (código abierto) — solo pagas los costes de la API del modelo
Consejo: Usa Haiku para iteración en eval; cambia a Sonnet solo para la verificación cruzada de modelos final

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Local network only by default

Almacenamiento de credenciales: Las claves API para modelos de eval se almacenan en localStorage del navegador por defecto — límpialas después de usar en máquinas compartidas

Salida de datos: Solo a los proveedores de modelos que configures (Anthropic, OpenAI, etc.) y los servidores MCP que conectes

No conceder nunca: Acceso a internet público — mantén el inspector en localhost

Inspeccionar un servidor MCP malicioso igual ejecuta el código de ese servidor en tu máquina — pon en sandbox los desconocidos

Resolución de problemas

Errores comunes y soluciones

El servidor falla al conectar (stdio)

Verifica que la ruta del comando es absoluta y el directorio de trabajo está configurado; revisa stderr en el panel de logs del inspector

Verificar: Run the server command manually in a terminal first

El servidor SSE se cuelga al conectar

Problema de CORS o cabecera de auth — verifica que el endpoint SSE acepta solicitudes cross-origin desde localhost:6274

Verificar: curl -N <sse_url> with -H 'Accept: text/event-stream'

La evaluación se ejecuta pero todos los modelos fallan

Verifica la validez de la clave API en ajustes; comprueba que los nombres de modelo coinciden con la nomenclatura actual del proveedor

El puerto del inspector ya está en uso

PORT=6275 npx @mcpjam/inspector

Verificar: lsof -i :6274

Alternativas

MCPJam Inspector vs otros

Alternativa	Cuándo usarla	Contrapartida
modelcontextprotocol/inspector (official)	Quieres el inspector de referencia canónico con el conjunto de funciones más conservador	Sin modos chat/eval; más bajo nivel
wong2/mcp-cli	Prefieres terminal sobre UI	Sin comparación visual de eval ni renderizado de esquemas

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills