@standardbeagle/mcp-tui 0.2.1 → 0.4.0

package/README.md

@@ -34,12 +34,13 @@ Stop struggling with curl commands, JSON formatting, and connection issues. MCP-
 - Batch operations and parallel execution capabilities
 - Exit codes and error handling perfect for scripts
 
-### Universal Transport Support
-**Problem Solved:** Connect to any MCP server regardless of how it's built
-- STDIO transport for local processes and development
-- HTTP/SSE transport for web services and cloud deployments
-- Automatic transport detection based on connection parameters
-- Cross-platform process management with proper cleanup
+### Transport Support
+**Problem Solved:** Connect to MCP servers with reliable, standards-compliant transport
+- ✅ **STDIO transport** for local processes and command execution
+- ✅ **SSE (Server-Sent Events)** transport for web services and cloud deployments
+- ✅ **HTTP transport** for standard web APIs and RESTful services
+- ✅ **Streamable HTTP** transport for advanced MCP protocol compliance
+- Built on official MCP Go SDK for maximum compatibility and protocol compliance
 
 ### Robust Error Handling
 **Problem Solved:** Understand exactly what's wrong when servers misbehave
@@ -48,6 +49,17 @@ Stop struggling with curl commands, JSON formatting, and connection issues. MCP-
 - Test servers that simulate real-world failure scenarios
 - Graceful degradation when servers become unresponsive
 
+### Enhanced Navigation & File Discovery
+**Problem Solved:** Stop re-typing server configurations and struggle to find existing configs
+- **Tabbed interface** with visual navigation between saved/discovered/manual modes
+- **Smart file discovery** automatically finds Claude Desktop, VS Code, and MCP configs
+- **Combined command input** - type "brum --mcp" in one field, not separate command/args
+- **Arrow key navigation** between tabs and intuitive UI flow
+- Auto-connect to single server setups or configured default servers
+- Compatible with Claude Desktop and VS Code MCP configurations
+- Recent connections tracking with success status
+- Environment variable substitution for secure credential management
+
 ## 🚀 Get Started in 30 Seconds
 
 ### Installation
@@ -73,27 +85,45 @@ make install
 ```
 *Benefits: Latest features, customizable, contribute back*
 
-### Instant Connection - Choose Your Style
+### Instant Connection - Enhanced Experience
+
+> **✨ New in v0.2.0**: Revolutionary UI with saved connections, file discovery, tabbed navigation, and combined command input. Built on the official MCP Go SDK with comprehensive security validation.
 
 **🎯 Just Getting Started? Try This:**
 ```bash
-# One command gets you browsing any MCP server visually
+# Open the enhanced TUI with file discovery and saved connections
+mcp-tui
+
+# Quick connect to MCP server via STDIO (single command line)
 mcp-tui "npx -y @modelcontextprotocol/server-everything stdio"
+
+# Or connect via SSE (Server-Sent Events) for web servers
+mcp-tui --url http://localhost:8000/sse
+```
+*What's new: Visual tabs, file discovery finds existing configs, combined command input, arrow key navigation*
+
+**💡 Smart Auto-Connect:**
+If you have a saved configuration file with a single server or default server, MCP-TUI will auto-connect immediately:
+```bash
+# Create ~/.config/mcp-tui/connections.json or copy examples/single-server-config.json
+mcp-tui  # Connects automatically!
 ```
-*Why this works: Skips all setup, connects instantly, shows you everything the server can do*
 
 **🤖 Building Automation? Use CLI Mode:**
 ```bash
-# List all available tools
+# List all available tools via STDIO (combined command input) 
 mcp-tui "npx -y @modelcontextprotocol/server-everything stdio" tool list
 
+# Or via SSE
+mcp-tui --url http://localhost:8000/sse tool list
+
 # Execute a specific tool with parameters
-mcp-tui "npx -y @modelcontextprotocol/server-everything stdio" tool call echo message="Hello World"
+mcp-tui --url http://localhost:8000/sse tool call echo message="Hello World"
 
 # Get JSON output for your scripts
-mcp-tui --json "npx -y @modelcontextprotocol/server-everything stdio" tool list
+mcp-tui --json --url http://localhost:8000/sse tool list
 ```
-*Why this works: Perfect for CI/CD, scripts, and automated testing workflows*
+*Why this works: Combined command input, perfect for CI/CD, scripts, and automated testing workflows*
 
 **🌐 Have a Web Service? Connect via HTTP:**
 ```bash
@@ -322,14 +352,16 @@ mcp-tui prompt get <name> [args...]    # Get a prompt with arguments
 
 ### Global Options
 ```bash
---cmd string         # Command to run MCP server (for STDIO)
---args strings       # Arguments for server command (use multiple flags)
---url string         # URL for SSE/HTTP servers
---type string        # Transport type (stdio, sse, http)
+--url string         # URL for SSE servers (primary method)
+--type string        # Transport type (currently: sse)
 --timeout duration   # Connection timeout (default 30s)
 --debug             # Enable debug mode with detailed logging
 --log-level string  # Log level (debug, info, warn, error)
 --json              # Output results in JSON format
+
+# Legacy options (STDIO support coming back soon):
+--cmd string         # Command to run MCP server (not yet implemented)
+--args strings       # Arguments for server command (not yet implemented)
 ```
 
 ## 🔍 Error Handling & Debugging
@@ -431,6 +463,21 @@ Error: PROTOCOL_VIOLATION: missing required field 'protocolVersion'
 Error: SERVER_NOT_RESPONDING: no response to initialize request
 ```
 
+**Debugging JSON Unmarshaling Errors:**
+
+When servers send malformed responses, use `--debug` flag for detailed diagnostics:
+
+```bash
+# Example: Server sends array instead of object for properties field
+mcp-tui --debug --url http://localhost:8080/mcp tool list
+
+# Enhanced error output shows:
+# - Original error message
+# - Raw HTTP response body
+# - Specific field causing the issue
+# - Expected vs received types
+```
+
 ## 🎯 Type System & Validation
 
 ### Automatic Type Conversion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standardbeagle/mcp-tui",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "A Terminal User Interface (TUI) and CLI for Model Context Protocol (MCP) servers",
   "main": "index.js",
   "bin": {