Repolode
standardbeagle

standardbeagle/mcp-tui

Interfaz de terminal y CLI para probar, depurar y automatizar servidores Model Context Protocol (MCP) por stdio, SSE y HTTP.

Alternativa open source a:Postman

Estrellas
12
Forks
2
Issues abiertos
15
Último commit
hace 4 días

¿Qué es?

mcp-tui permite conectarse a un servidor Model Context Protocol desde la terminal, elegir una herramienta, completar un formulario generado a partir de su esquema de entrada y ejecutar la llamada. También se puede copiar cada llamada como un comando CLI equivalente, para pasar de una prueba manual a un script de shell o un trabajo de CI.

Si falla la conexión, la herramienta indica la causa concreta —por ejemplo, un HTTP 404 debido a una ruta incorrecta, una discrepancia de transporte, un servidor stdio que escribe los registros en stdout o la falta de inicio de sesión OAuth— y sugiere cómo solucionarlo. También registra cada mensaje JSON-RPC en ambas direcciones, los tiempos de HTTP y cada paso del flujo OAuth, con las credenciales ocultas.

El proyecto incluye el comando `verify` para realizar pruebas de especificación y seguridad, y el comando `conform`, que ejecuta escenarios del protocolo y genera un informe JUnit. Está basado en el SDK oficial de MCP para Go y se distribuye mediante `go install` y npm.

Funciones clave

  • 01Genera en la TUI un formulario para llamar a cada herramienta a partir de su esquema de entrada.
  • 02Ejecuta las mismas llamadas desde la CLI y devuelve la salida en JSON para usarla con jq.
  • 03Explica las causas de los fallos de conexión y cómo solucionarlos.
  • 04Registra cada mensaje JSON-RPC, los tiempos de HTTP y cada paso de OAuth.
  • 05Exporta las sesiones de la TUI como scripts de shell que se pueden volver a ejecutar.
  • 06Genera informes JUnit de conformidad para CI.

Casos de uso

  • Probar manualmente las herramientas de un servidor MCP nuevo antes de integrarlo con un cliente de IA.
  • Depurar por qué no se puede conectar con un servidor MCP por HTTP o stdio.
  • Añadir pruebas de conformidad de servidores MCP a un pipeline de CI.
  • Automatizar llamadas repetibles a las herramientas de un servidor MCP desde el shell.

Inicio rápido

  1. 1

    Instalar con Go

    go install github.com/standardbeagle/mcp-tui@latest
  2. 2

    O instalar con npm

    npm install -g @standardbeagle/mcp-tui
  3. 3

    Abrir la TUI conectada a un servidor HTTP MCP

    mcp-tui --url http://localhost:8080/mcp

Antes de usarlo

  • Es un proyecto en una fase inicial, con solo 12 estrellas, por lo que su adopción y trayectoria son limitadas.

Temas

Preguntas frecuentes

¿Qué es mcp-tui?
Interfaz de terminal y CLI para probar, depurar y automatizar servidores Model Context Protocol (MCP) por stdio, SSE y HTTP. mcp-tui permite conectarse a un servidor Model Context Protocol desde la terminal, elegir una herramienta, completar un formulario generado a partir de su esquema de entrada y ejecutar la llamada. También se puede copiar cada llamada como un comando CLI equivalente, para pasar de una prueba manual a un script de shell o un trabajo de CI.
¿mcp-tui es gratuito? ¿Qué licencia tiene?
mcp-tui es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-tui sigue mantenido?
Mantenimiento activo. El último commit de mcp-tui fue el 18 oct 2026.
¿Para qué puedo usar mcp-tui?
Probar manualmente las herramientas de un servidor MCP nuevo antes de integrarlo con un cliente de IA. Depurar por qué no se puede conectar con un servidor MCP por HTTP o stdio. Añadir pruebas de conformidad de servidores MCP a un pipeline de CI. Automatizar llamadas repetibles a las herramientas de un servidor MCP desde el shell.
¿Cómo se instala mcp-tui?
Instalar con Go: go install github.com/standardbeagle/mcp-tui@latest O instalar con npm: npm install -g @standardbeagle/mcp-tui Abrir la TUI conectada a un servidor HTTP MCP: mcp-tui --url http://localhost:8080/mcp
¿Dónde consigo mcp-tui?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/standardbeagle/mcp-tui

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

Proyectos relacionados