mcp-tui

README

MCP-TUI

Fast terminal UI and CLI for testing, debugging, and automating Model Context Protocol servers.

STDIO, SSE, HTTP, and Streamable HTTP transports — built on the official MCP Go SDK.

Install

# Go (recommended)
go install github.com/standardbeagle/mcp-tui@latest

# npm
npm install -g @standardbeagle/mcp-tui

Quick start

Launch the TUI against the official sample server:

mcp-tui --cmd npx --args "@modelcontextprotocol/server-everything,stdio"

Or use CLI mode for scripting:

mcp-tui --cmd npx --args "@modelcontextprotocol/server-everything,stdio" tool list

mcp-tui --cmd npx --args "@modelcontextprotocol/server-everything,stdio" \
  tool call echo message='hello mcp'

What it does

• Visual exploration — browse tools, resources, prompts; execute with auto-generated forms.
• CI-friendly CLI — every TUI action has a CLI equivalent. c in the TUI copies it.
• All MCP transports — STDIO, SSE, HTTP, Streamable HTTP.
• Config discovery — finds Claude Desktop, VS Code MCP, and native configs automatically.
• Real debugging — Ctrl+D opens HTTP timing, MCP message trace, and structured error classification.

Documentation

Full docs at https://standardbeagle.github.io/mcp-tui/.

• Install
• Quick start
• TUI guide
• CLI reference
• Transports
• Automation & CI
• Debugging

Contributing

See CONTRIBUTING.md and ARCHITECTURE.md. Issues and PRs welcome.

License

MIT