@standardbeagle/mcp-tui 0.5.0 → 0.7.0

package/examples/mcp-config.yaml

@@ -0,0 +1,78 @@
+connection:
+  type: stdio
+  command: npx
+  args:
+    - "-y"
+    - "@modelcontextprotocol/server-everything"
+    - "stdio"
+  connection_timeout: 30s
+  request_timeout: 30s
+  health_check_timeout: 5s
+  deny_unsafe_commands: true
+
+transport:
+  http:
+    timeout: 30s
+    max_idle_conns: 100
+    max_idle_conns_per_host: 10
+    idle_conn_timeout: 90s
+    tls_min_version: "1.2"
+    user_agent: "mcp-tui/0.1.0"
+  
+  stdio:
+    command_validation: true
+    max_processes: 10
+    process_timeout: 300s
+    kill_timeout: 10s
+  
+  sse:
+    reconnect_interval: 5s
+    max_reconnect_attempts: 5
+    buffer_size: 8192
+    read_timeout: 30s
+    write_timeout: 10s
+
+session:
+  health_check_interval: 30s
+  health_check_timeout: 5s
+  max_reconnect_attempts: 3
+  reconnect_delay: 2s
+  reconnect_backoff: exponential
+  max_reconnect_delay: 60s
+  enable_persistence: false
+  persistence_interval: 60s
+
+error_handling:
+  enable_classification: true
+  user_friendly_messages: true
+  max_error_history: 1000
+  error_reporting: false
+  enable_retry: true
+  max_retry_attempts: 3
+  retry_delay: 1s
+  retry_backoff: exponential
+
+debug:
+  enabled: false
+  log_level: info
+  event_tracing: false
+  max_traced_events: 1000
+  http_debugging: false
+  http_trace_body: false
+  http_trace_headers: false
+  pretty_print: true
+  colored_output: true
+  timestamp_format: "2006-01-02T15:04:05Z07:00"
+  export_events: false
+  export_format: json
+
+cli:
+  output_format: table
+  quiet_mode: false
+  verbose_mode: false
+  no_color: false
+  show_progress: true
+  progress_style: bar
+  enable_clipboard: true
+  enable_paging: true
+  page_size: 25

package/examples/multi-server-config.json

@@ -0,0 +1,106 @@
+{
+  "servers": [
+    {
+      "name": "filesystem",
+      "connection": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@modelcontextprotocol/server-filesystem",
+          "/home/user/projects",
+          "/home/user/documents"
+        ]
+      },
+      "description": "File system access server",
+      "enabled": true
+    },
+    {
+      "name": "weather-api",
+      "connection": {
+        "type": "http",
+        "url": "http://localhost:8000/mcp"
+      },
+      "description": "Weather data API server",
+      "enabled": true,
+      "transport": {
+        "http": {
+          "headers": {
+            "Authorization": "Bearer ${WEATHER_API_KEY}"
+          }
+        }
+      }
+    },
+    {
+      "name": "database",
+      "connection": {
+        "type": "stdio",
+        "command": "python",
+        "args": [
+          "/opt/mcp-servers/database/server.py",
+          "--config",
+          "/etc/mcp/database.conf"
+        ]
+      },
+      "description": "Database access server",
+      "enabled": true,
+      "session": {
+        "health_check_interval": "60s",
+        "max_reconnect_attempts": 5
+      }
+    },
+    {
+      "name": "realtime-data",
+      "connection": {
+        "type": "sse",
+        "url": "http://localhost:3000/sse",
+        "headers": {
+          "X-API-Key": "${REALTIME_API_KEY}"
+        }
+      },
+      "description": "Real-time data streaming server",
+      "enabled": true,
+      "transport": {
+        "sse": {
+          "reconnect_interval": "10s",
+          "max_reconnect_attempts": 10,
+          "buffer_size": 16384
+        }
+      }
+    },
+    {
+      "name": "development-server",
+      "connection": {
+        "type": "stdio",
+        "command": "./dev-server",
+        "args": ["--mcp", "--verbose"],
+        "working_directory": "/home/user/dev/my-mcp-server"
+      },
+      "description": "Local development MCP server",
+      "enabled": false,
+      "debug": {
+        "enabled": true,
+        "log_level": "debug"
+      }
+    }
+  ],
+  "defaults": {
+    "connection": {
+      "connection_timeout": "30s",
+      "request_timeout": "30s",
+      "health_check_timeout": "5s"
+    },
+    "session": {
+      "health_check_interval": "30s",
+      "max_reconnect_attempts": 3,
+      "reconnect_delay": "2s",
+      "reconnect_backoff": "exponential"
+    },
+    "error_handling": {
+      "enable_classification": true,
+      "user_friendly_messages": true,
+      "enable_retry": true,
+      "max_retry_attempts": 3
+    }
+  }
+}

package/examples/multi-transport-config.json

@@ -0,0 +1,67 @@
+{
+  "version": "1.0",
+  "defaultServer": "filesystem",
+  "servers": {
+    "filesystem": {
+      "id": "filesystem",
+      "name": "Local Filesystem",
+      "description": "Access local files and directories",
+      "icon": "📁",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/workspace"],
+      "success": false,
+      "tags": ["local", "files"]
+    },
+    "api-server": {
+      "id": "api-server",
+      "name": "API Gateway",
+      "description": "REST API integration server",
+      "icon": "🌐",
+      "transport": "http",
+      "url": "http://localhost:8080/mcp",
+      "headers": {
+        "X-API-Key": "${env:API_KEY}",
+        "Content-Type": "application/json"
+      },
+      "success": false,
+      "tags": ["api", "remote"]
+    },
+    "event-stream": {
+      "id": "event-stream",
+      "name": "Event Stream Server",
+      "description": "Real-time event streaming via SSE",
+      "icon": "⚡",
+      "transport": "sse",
+      "url": "http://localhost:3000/sse",
+      "headers": {
+        "Authorization": "Bearer ${env:EVENT_TOKEN}"
+      },
+      "success": false,
+      "tags": ["events", "realtime"]
+    },
+    "memory": {
+      "id": "memory",
+      "name": "Memory Server",
+      "description": "Persistent memory storage",
+      "icon": "🧠",
+      "transport": "stdio",
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-v", "mcp-memory:/data", "mcp/memory-server"],
+      "success": false,
+      "tags": ["memory", "docker"]
+    }
+  },
+  "recentConnections": [
+    {
+      "serverId": "filesystem",
+      "lastUsed": "2025-01-12T10:30:00Z",
+      "success": true
+    },
+    {
+      "serverId": "api-server",
+      "lastUsed": "2025-01-12T09:15:00Z",
+      "success": true
+    }
+  ]
+}

package/examples/production-setup.json

@@ -0,0 +1,61 @@
+{
+  "version": "1.0",
+  "servers": {
+    "auth-service": {
+      "id": "auth-service",
+      "name": "Authentication Service",
+      "description": "Production authentication API",
+      "icon": "🔐",
+      "transport": "http",
+      "url": "https://auth.company.com/mcp",
+      "headers": {
+        "X-Service-Key": "${env:AUTH_SERVICE_KEY}",
+        "X-Environment": "production"
+      },
+      "success": false,
+      "tags": ["auth", "production", "api"]
+    },
+    "user-data": {
+      "id": "user-data",
+      "name": "User Data Service",
+      "description": "Production user data API",
+      "icon": "👤",
+      "transport": "http",
+      "url": "https://users.company.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${env:USER_SERVICE_TOKEN}",
+        "X-Client-Version": "1.0.0"
+      },
+      "success": false,
+      "tags": ["users", "production", "api"]
+    },
+    "monitoring": {
+      "id": "monitoring",
+      "name": "Monitoring Events",
+      "description": "Real-time monitoring and alerts",
+      "icon": "📊",
+      "transport": "sse",
+      "url": "https://monitor.company.com/events",
+      "headers": {
+        "Authorization": "Bearer ${env:MONITOR_TOKEN}",
+        "X-Stream-Type": "alerts"
+      },
+      "success": false,
+      "tags": ["monitoring", "production", "events"]
+    },
+    "analytics": {
+      "id": "analytics",
+      "name": "Analytics Database",
+      "description": "Production analytics PostgreSQL",
+      "icon": "🐘",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres", "${env:ANALYTICS_DB_URL}"],
+      "environment": {
+        "PGPASSWORD": "${env:ANALYTICS_DB_PASSWORD}"
+      },
+      "success": false,
+      "tags": ["analytics", "production", "database"]
+    }
+  }
+}

package/examples/single-server-config.json

@@ -0,0 +1,16 @@
+{
+  "version": "1.0",
+  "defaultServer": "everything",
+  "servers": {
+    "everything": {
+      "id": "everything",
+      "name": "Everything Server",
+      "description": "Official MCP server with everything for testing",
+      "icon": "🌟",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-everything", "stdio"],
+      "success": false
+    }
+  }
+}

package/examples/transport-examples.json

@@ -0,0 +1,140 @@
+{
+  "stdio_examples": {
+    "npm_package": {
+      "connection": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@modelcontextprotocol/server-everything", "stdio"]
+      }
+    },
+    "python_server": {
+      "connection": {
+        "type": "stdio",
+        "command": "python",
+        "args": ["server.py", "--mode", "mcp"]
+      }
+    },
+    "node_server": {
+      "connection": {
+        "type": "stdio",
+        "command": "node",
+        "args": ["dist/index.js"]
+      }
+    },
+    "go_binary": {
+      "connection": {
+        "type": "stdio",
+        "command": "./mcp-server",
+        "args": ["--config", "server.conf"]
+      }
+    },
+    "docker_container": {
+      "connection": {
+        "type": "stdio",
+        "command": "docker",
+        "args": ["run", "-i", "my-mcp-server:latest"]
+      }
+    }
+  },
+  
+  "http_examples": {
+    "basic_http": {
+      "connection": {
+        "type": "http",
+        "url": "http://localhost:8080/mcp"
+      }
+    },
+    "https_with_auth": {
+      "connection": {
+        "type": "http",
+        "url": "https://api.example.com/mcp",
+        "headers": {
+          "Authorization": "Bearer ${API_TOKEN}",
+          "X-API-Version": "2025-01-01"
+        }
+      },
+      "transport": {
+        "http": {
+          "tls_min_version": "1.3",
+          "timeout": "60s"
+        }
+      }
+    },
+    "http_with_proxy": {
+      "connection": {
+        "type": "http",
+        "url": "http://internal.corp.com/mcp"
+      },
+      "transport": {
+        "http": {
+          "proxy_url": "http://proxy.corp.com:8080",
+          "proxy_headers": {
+            "Proxy-Authorization": "Basic ${PROXY_AUTH}"
+          }
+        }
+      }
+    }
+  },
+  
+  "sse_examples": {
+    "basic_sse": {
+      "connection": {
+        "type": "sse",
+        "url": "http://localhost:3000/sse"
+      }
+    },
+    "sse_with_auth": {
+      "connection": {
+        "type": "sse",
+        "url": "https://stream.example.com/mcp/sse",
+        "headers": {
+          "Authorization": "Bearer ${STREAM_TOKEN}"
+        }
+      },
+      "transport": {
+        "sse": {
+          "reconnect_interval": "5s",
+          "max_reconnect_attempts": 10,
+          "buffer_size": 16384,
+          "read_timeout": "0s"
+        }
+      }
+    },
+    "sse_with_event_filtering": {
+      "connection": {
+        "type": "sse",
+        "url": "http://localhost:3000/events"
+      },
+      "transport": {
+        "sse": {
+          "event_types": ["tool", "resource", "log"],
+          "ignore_events": ["heartbeat", "ping"]
+        }
+      }
+    }
+  },
+  
+  "streamable_http_examples": {
+    "basic_streamable": {
+      "connection": {
+        "type": "streamable-http",
+        "url": "http://localhost:8080/mcp/stream"
+      }
+    },
+    "streamable_with_chunking": {
+      "connection": {
+        "type": "streamable-http",
+        "url": "https://api.example.com/v2/mcp"
+      },
+      "transport": {
+        "http": {
+          "timeout": "0s",
+          "default_headers": {
+            "Accept": "application/x-ndjson",
+            "X-Stream-Mode": "chunked"
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@standardbeagle/mcp-tui",
-  "version": "0.5.0",
-  "description": "A Terminal User Interface (TUI) and CLI for Model Context Protocol (MCP) servers",
+  "version": "0.7.0",
+  "description": "A comprehensive Terminal User Interface (TUI) and Command Line Interface (CLI) for Model Context Protocol (MCP) servers with full tool, prompt, and resource management",
   "main": "index.js",
   "bin": {
     "mcp-tui": "bin/mcp-tui.js"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "go test ./...",
+    "build": "go build -o bin/mcp-tui .",
+    "prepare": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -21,7 +23,13 @@
     "terminal",
     "cli",
     "ai",
-    "llm"
+    "llm",
+    "tools",
+    "prompts",
+    "resources",
+    "server-testing",
+    "debugging",
+    "development"
   ],
   "author": "standardbeagle",
   "license": "MIT",
@@ -36,8 +44,11 @@
   "files": [
     "bin/",
     "scripts/",
+    "examples/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md",
+    "QUICK_START.md"
   ],
   "engines": {
     "node": ">=14.0.0"

package/scripts/install.js

@@ -61,6 +61,20 @@ async function downloadBinary() {
     fs.mkdirSync(binariesDir, { recursive: true });
   }
   
+  // Check if binary is already included in the npm package
+  const includedBinaryPath = path.join(__dirname, '..', 'bin', binaryName);
+  if (fs.existsSync(includedBinaryPath)) {
+    console.log('Using pre-built binary from package...');
+    // Copy the binary to the expected location
+    fs.copyFileSync(includedBinaryPath, binaryPath);
+    // Make binary executable
+    if (process.platform !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+    console.log('Binary installed successfully!');
+    return;
+  }
+
   // For development, try to build from source if available
   if (fs.existsSync(path.join(__dirname, '..', '..', 'go.mod'))) {
     console.log('Development mode: Building from source...');