Repolode
Enviar
standardbeagle

standardbeagle/mcp-tui

Interface de terminal e CLI para testar, depurar e automatizar servidores Model Context Protocol (MCP) via stdio, SSE e HTTP.

Alternativa open source a:Postman

Ver no GitHubSite
Estrelas
12
Forks
2
Issues abertas
15
Último commit
há 4 dias

O que é?

mcp-tui permite conectar-se a um servidor Model Context Protocol pelo terminal, escolher uma ferramenta, preencher um formulário gerado com base no esquema de entrada dela e executar a chamada. Também é possível copiar cada chamada como um comando CLI equivalente, facilitando transformar uma verificação manual em um script de shell ou tarefa de CI.

Quando uma conexão falha, a ferramenta informa a causa específica — como um HTTP 404 no caminho errado, uma incompatibilidade de transporte, um servidor stdio escrevendo logs em stdout ou a falta de autenticação OAuth — e sugere uma solução. Ela também registra todas as mensagens JSON-RPC nos dois sentidos, os tempos das requisições HTTP e cada etapa do fluxo OAuth, ocultando as credenciais.

O projeto inclui o comando `verify`, que faz verificações da especificação e de segurança, e o comando `conform`, que executa cenários do protocolo e gera um relatório JUnit. Ele é desenvolvido com base no SDK oficial MCP para Go e distribuído via `go install` e npm.

Recursos principais

  • 01Gera, na TUI, um formulário de chamada para cada ferramenta com base no esquema de entrada dela.
  • 02Executa as mesmas chamadas pela CLI e gera saída JSON para uso com jq.
  • 03Explica as falhas de conexão, indicando causas e soluções.
  • 04Registra todas as mensagens JSON-RPC, os tempos das requisições HTTP e cada etapa do OAuth.
  • 05Exporta sessões da TUI como scripts de shell que podem ser executados novamente.
  • 06Gera relatórios de conformidade JUnit para CI.

Casos de uso

  • Testar manualmente as ferramentas de um novo servidor MCP antes de integrá-lo a um cliente de IA.
  • Depurar por que um servidor MCP não consegue se conectar via HTTP ou stdio.
  • Adicionar verificações de conformidade de servidores MCP a um pipeline de CI.
  • Criar scripts de shell para repetir chamadas de ferramentas a um servidor MCP.

Início rápido

  1. 1

    Instalar com Go

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

    Ou instalar com npm

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

    Abrir a TUI conectada a um servidor HTTP MCP

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

Antes de usar

  • É um projeto em estágio inicial, com apenas 12 estrelas, portanto sua adoção e seu histórico são limitados.

Tópicos

#mcp#model-context-protocol#terminal-ui#cli#testing-tools#debugging#llm-tools#go#ai-tools#anthropic

Perguntas frequentes

O que é mcp-tui?
Interface de terminal e CLI para testar, depurar e automatizar servidores Model Context Protocol (MCP) via stdio, SSE e HTTP. mcp-tui permite conectar-se a um servidor Model Context Protocol pelo terminal, escolher uma ferramenta, preencher um formulário gerado com base no esquema de entrada dela e executar a chamada. Também é possível copiar cada chamada como um comando CLI equivalente, facilitando transformar uma verificação manual em um script de shell ou tarefa de CI.
mcp-tui é gratuito? Qual é a licença?
mcp-tui é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-tui ainda é mantido?
Manutenção ativa. O último commit de mcp-tui foi em 18 de out. de 2026.
Para que posso usar mcp-tui?
Testar manualmente as ferramentas de um novo servidor MCP antes de integrá-lo a um cliente de IA. Depurar por que um servidor MCP não consegue se conectar via HTTP ou stdio. Adicionar verificações de conformidade de servidores MCP a um pipeline de CI. Criar scripts de shell para repetir chamadas de ferramentas a um servidor MCP.
Como instalar mcp-tui?
Instalar com Go: go install github.com/standardbeagle/mcp-tui@latest Ou instalar com npm: npm install -g @standardbeagle/mcp-tui Abrir a TUI conectada a um servidor HTTP MCP: mcp-tui --url http://localhost:8080/mcp
Onde consigo mcp-tui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/standardbeagle/mcp-tui

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados