aidevops 2.52.1

package/.agent/scripts/mcp-diagnose.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+# MCP Connection Failure Diagnostics
+# Usage: mcp-diagnose.sh <mcp-name>
+#
+# Diagnoses common MCP connection issues:
+# - Command availability
+# - Version mismatches
+# - Configuration errors
+# - Known breaking changes
+
+set -euo pipefail
+
+# Colors
+readonly GREEN='\033[0;32m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly BLUE='\033[0;34m'
+readonly NC='\033[0m'
+
+MCP_NAME="${1:-}"
+
+if [[ -z "$MCP_NAME" ]]; then
+    echo "Usage: mcp-diagnose.sh <mcp-name>"
+    echo ""
+    echo "Examples:"
+    echo "  mcp-diagnose.sh osgrep"
+    echo "  mcp-diagnose.sh augment-context-engine"
+    exit 1
+fi
+
+echo -e "${BLUE}=== MCP Diagnosis: $MCP_NAME ===${NC}"
+echo ""
+
+# 1. Check if command exists
+echo "1. Checking command availability..."
+# Map MCP names to their CLI commands
+case "$MCP_NAME" in
+    augment-context-engine|augment)
+        CLI_CMD="auggie"
+        NPM_PKG="@augmentcode/auggie"
+        ;;
+    osgrep)
+        CLI_CMD="osgrep"
+        NPM_PKG="osgrep"
+        ;;
+    context7)
+        CLI_CMD="context7"
+        NPM_PKG="@context7/mcp"
+        ;;
+    *)
+        CLI_CMD="$MCP_NAME"
+        NPM_PKG="$MCP_NAME"
+        ;;
+esac
+
+if command -v "$CLI_CMD" &>/dev/null; then
+    echo -e "   ${GREEN}✓ Command found: $(which "$CLI_CMD")${NC}"
+    INSTALLED_VERSION=$("$CLI_CMD" --version 2>/dev/null | head -1 || echo 'unknown')
+    echo "   Version: $INSTALLED_VERSION"
+else
+    echo -e "   ${RED}✗ Command not found: $CLI_CMD${NC}"
+    echo "   Try: npm install -g $NPM_PKG"
+    exit 1
+fi
+
+# 2. Check latest version
+echo ""
+echo "2. Checking for updates..."
+LATEST_VERSION=$(npm view "$NPM_PKG" version 2>/dev/null || echo "unknown")
+echo "   Installed: $INSTALLED_VERSION"
+echo "   Latest:    $LATEST_VERSION"
+
+if [[ "$INSTALLED_VERSION" != *"$LATEST_VERSION"* ]] && [[ "$LATEST_VERSION" != "unknown" ]]; then
+    echo -e "   ${YELLOW}⚠️  UPDATE AVAILABLE - run: npm update -g $NPM_PKG${NC}"
+fi
+
+# 3. Check OpenCode config
+echo ""
+echo "3. Checking OpenCode configuration..."
+CONFIG_FILE="$HOME/.config/opencode/opencode.json"
+if [[ -f "$CONFIG_FILE" ]]; then
+    if grep -q "\"$MCP_NAME\"" "$CONFIG_FILE"; then
+        echo -e "   ${GREEN}✓ MCP configured in opencode.json${NC}"
+        # Extract and show the command using Python
+        python3 -c "
+import json
+with open('$CONFIG_FILE') as f:
+    cfg = json.load(f)
+mcp = cfg.get('mcp', {}).get('$MCP_NAME', {})
+cmd = mcp.get('command', 'not set')
+enabled = mcp.get('enabled', 'not set')
+print(f'   Command: {cmd}')
+print(f'   Enabled: {enabled}')
+" 2>/dev/null || echo "   (Could not parse config)"
+    else
+        echo -e "   ${RED}✗ MCP not found in config${NC}"
+    fi
+else
+    echo -e "   ${RED}✗ Config file not found: $CONFIG_FILE${NC}"
+fi
+
+# 4. Check for known breaking changes
+echo ""
+echo "4. Known issues for $MCP_NAME..."
+case "$MCP_NAME" in
+    osgrep)
+        echo "   - v0.4.x: Used 'osgrep serve' (HTTP server, NOT MCP-compatible)"
+        echo "   - v0.5.x: Use 'osgrep mcp' or run 'osgrep install-opencode'"
+        echo ""
+        echo "   If using v0.5+, the correct command is: [\"osgrep\", \"mcp\"]"
+        ;;
+    augment-context-engine|augment)
+        echo "   - Requires 'auggie login' before MCP works"
+        echo "   - Session stored in ~/.augment/"
+        echo "   - Correct command: [\"auggie\", \"--mcp\"]"
+        ;;
+    context7)
+        echo "   - Remote MCP, no local command needed"
+        echo "   - Use: \"type\": \"remote\", \"url\": \"https://mcp.context7.com/mcp\""
+        ;;
+    *)
+        echo "   No known issues documented for this MCP"
+        ;;
+esac
+
+# 5. Test MCP command directly
+echo ""
+echo "5. Testing MCP command (5 second timeout)..."
+
+# Use gtimeout on macOS if available, otherwise skip timeout
+TIMEOUT_CMD=""
+if command -v gtimeout &>/dev/null; then
+    TIMEOUT_CMD="gtimeout 5"
+elif command -v timeout &>/dev/null; then
+    TIMEOUT_CMD="timeout 5"
+fi
+
+case "$MCP_NAME" in
+    osgrep)
+        echo "   Running: osgrep mcp"
+        if [[ -n "$TIMEOUT_CMD" ]]; then
+            $TIMEOUT_CMD osgrep mcp 2>&1 | head -3 || echo "   (timeout - normal for MCP servers)"
+        else
+            echo "   (skipping - install coreutils for timeout: brew install coreutils)"
+        fi
+        ;;
+    augment-context-engine|augment)
+        echo "   Running: auggie --mcp"
+        if [[ -n "$TIMEOUT_CMD" ]]; then
+            $TIMEOUT_CMD auggie --mcp 2>&1 | head -3 || echo "   (timeout - normal for MCP servers)"
+        else
+            echo "   (skipping - install coreutils for timeout: brew install coreutils)"
+        fi
+        ;;
+    *)
+        echo "   Skipping direct test (unknown command pattern)"
+        ;;
+esac
+
+# 6. Suggested fixes
+echo ""
+echo -e "${BLUE}=== Suggested Fixes ===${NC}"
+echo "1. Update tool: npm update -g $NPM_PKG"
+echo "2. Check official docs for command changes"
+echo "3. Run: $CLI_CMD --help"
+echo "4. Check ~/.aidevops/agents/tools/ for updated documentation"
+echo "5. Run: opencode mcp list (to verify status after fixes)"

package/.agent/scripts/mcp-inspector-helper.sh

@@ -0,0 +1,449 @@
+#!/usr/bin/env bash
+#
+# MCP Inspector Helper Script
+# Test and debug MCP servers using @modelcontextprotocol/inspector
+#
+# Usage: ./mcp-inspector-helper.sh [command] [options]
+#
+# Commands:
+#   ui [server]           Launch web UI for interactive testing
+#   list-tools [server]   List available tools from a server
+#   call-tool [server]    Call a specific tool
+#   list-resources        List available resources
+#   health                Check health of all configured servers
+#   config                Show current MCP configuration
+#   help                  Show this help message
+
+set -euo pipefail
+
+# Colors
+readonly GREEN='\033[0;32m'
+readonly BLUE='\033[0;34m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly CYAN='\033[0;36m'
+readonly NC='\033[0m'
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
+readonly SCRIPT_DIR
+readonly CONFIG_FILE="${SCRIPT_DIR}/../../.opencode/server/mcp-test-config.json"
+
+print_info() { 
+    local msg="$1"
+    echo -e "${BLUE}ℹ️  ${msg}${NC}"
+    return 0
+}
+
+print_success() { 
+    local msg="$1"
+    echo -e "${GREEN}✅ ${msg}${NC}"
+    return 0
+}
+
+print_warning() { 
+    local msg="$1"
+    echo -e "${YELLOW}⚠️  ${msg}${NC}"
+    return 0
+}
+
+print_error() { 
+    local msg="$1"
+    echo -e "${RED}❌ ${msg}${NC}"
+    return 0
+}
+
+print_header() { 
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    return 0
+}
+
+# Check if MCP Inspector is available
+check_inspector() {
+    if ! command -v npx &> /dev/null; then
+        print_error "npx not found. Please install Node.js first."
+        return 1
+    fi
+    return 0
+}
+
+# Launch MCP Inspector Web UI
+launch_ui() {
+    local server="${1:-}"
+    
+    print_header
+    echo -e "${CYAN}🔍 MCP Inspector - Web UI${NC}"
+    print_header
+    
+    if [[ -n "$server" ]]; then
+        print_info "Launching inspector for server: $server"
+        npx @modelcontextprotocol/inspector --config "$CONFIG_FILE" --server "$server"
+    else
+        print_info "Launching inspector with config file..."
+        print_info "Config: $CONFIG_FILE"
+        echo ""
+        print_info "Available servers:"
+        jq -r '.mcpServers | keys[]' "$CONFIG_FILE" 2>/dev/null || echo "  (config file not found)"
+        echo ""
+        npx @modelcontextprotocol/inspector --config "$CONFIG_FILE"
+    fi
+    return 0
+}
+
+# List tools from a server
+list_tools() {
+    local server="${1:-}"
+    
+    print_header
+    echo -e "${CYAN}🔧 MCP Inspector - List Tools${NC}"
+    print_header
+    
+    if [[ -z "$server" ]]; then
+        print_info "Listing tools from all configured servers..."
+        echo ""
+        
+        local srv
+        while IFS= read -r srv; do
+            echo -e "${BLUE}Server: ${srv}${NC}"
+            npx @modelcontextprotocol/inspector --cli --config "$CONFIG_FILE" --server "$srv" --method tools/list 2>/dev/null || print_warning "Failed to connect to $srv"
+            echo ""
+        done < <(jq -r '.mcpServers | keys[]' "$CONFIG_FILE" 2>/dev/null)
+    else
+        print_info "Listing tools from server: $server"
+        npx @modelcontextprotocol/inspector --cli --config "$CONFIG_FILE" --server "$server" --method tools/list
+    fi
+    return 0
+}
+
+# Call a tool
+call_tool() {
+    local server="${1:-}"
+    local tool_name="${2:-}"
+    shift 2 || true
+    local -a tool_args=("$@")
+    
+    if [[ -z "$server" || -z "$tool_name" ]]; then
+        print_error "Usage: call-tool <server> <tool-name> [--tool-arg key=value ...]"
+        return 1
+    fi
+    
+    print_header
+    echo -e "${CYAN}🎯 MCP Inspector - Call Tool${NC}"
+    print_header
+    print_info "Server: $server"
+    print_info "Tool: $tool_name"
+    
+    # Build args array safely
+    local -a cmd_args=("--cli" "--config" "$CONFIG_FILE" "--server" "$server" "--method" "tools/call" "--tool-name" "$tool_name")
+    
+    local arg
+    for arg in "${tool_args[@]}"; do
+        cmd_args+=("--tool-arg" "$arg")
+    done
+    
+    npx @modelcontextprotocol/inspector "${cmd_args[@]}"
+    return 0
+}
+
+# List resources
+list_resources() {
+    local server="${1:-}"
+    
+    print_header
+    echo -e "${CYAN}📚 MCP Inspector - List Resources${NC}"
+    print_header
+    
+    if [[ -z "$server" ]]; then
+        print_info "Listing resources from all configured servers..."
+        echo ""
+        
+        local srv
+        while IFS= read -r srv; do
+            echo -e "${BLUE}Server: ${srv}${NC}"
+            npx @modelcontextprotocol/inspector --cli --config "$CONFIG_FILE" --server "$srv" --method resources/list 2>/dev/null || print_warning "No resources or failed to connect"
+            echo ""
+        done < <(jq -r '.mcpServers | keys[]' "$CONFIG_FILE" 2>/dev/null)
+    else
+        print_info "Listing resources from server: $server"
+        npx @modelcontextprotocol/inspector --cli --config "$CONFIG_FILE" --server "$server" --method resources/list
+    fi
+    return 0
+}
+
+# Health check all servers
+health_check() {
+    print_header
+    echo -e "${CYAN}🏥 MCP Server Health Check${NC}"
+    print_header
+    
+    local total=0
+    local healthy=0
+    local failed=0
+    
+    # Check local Elysia servers first
+    echo -e "\n${BLUE}Local Elysia Servers:${NC}"
+    
+    local port
+    for port in 3100 3101; do
+        total=$((total + 1))
+        local name="localhost:$port"
+        local response
+        if response=$(curl -s "http://localhost:$port/health" 2>/dev/null); then
+            local status
+            status=$(echo "$response" | jq -r '.status // "ok"' 2>/dev/null || echo "healthy")
+            print_success "$name - $status"
+            healthy=$((healthy + 1))
+        else
+            print_error "$name - not running"
+            failed=$((failed + 1))
+        fi
+    done
+    
+    # Check MCP servers from config
+    echo -e "\n${BLUE}MCP Servers (from config):${NC}"
+    
+    local srv
+    while IFS= read -r srv; do
+        total=$((total + 1))
+        local server_type
+        server_type=$(jq -r ".mcpServers[\"$srv\"].type" "$CONFIG_FILE")
+        
+        if [[ "$server_type" == "streamable-http" || "$server_type" == "sse" ]]; then
+            local url
+            url=$(jq -r ".mcpServers[\"$srv\"].url" "$CONFIG_FILE")
+            if curl -s "$url/health" > /dev/null 2>&1; then
+                print_success "$srv ($server_type) - healthy"
+                healthy=$((healthy + 1))
+            else
+                print_warning "$srv ($server_type) - not reachable"
+                failed=$((failed + 1))
+            fi
+        else
+            # For stdio servers, just note they need manual testing
+            print_warning "$srv ($server_type) - stdio (use 'ui' to test)"
+        fi
+    done < <(jq -r '.mcpServers | keys[]' "$CONFIG_FILE" 2>/dev/null)
+    
+    echo ""
+    print_header
+    echo -e "Summary: ${GREEN}$healthy healthy${NC} / ${RED}$failed failed${NC} / $total total"
+    return 0
+}
+
+# Show configuration
+show_config() {
+    print_header
+    echo -e "${CYAN}⚙️  MCP Configuration${NC}"
+    print_header
+    
+    if [[ -f "$CONFIG_FILE" ]]; then
+        print_info "Config file: $CONFIG_FILE"
+        echo ""
+        jq '.' "$CONFIG_FILE"
+    else
+        print_error "Config file not found: $CONFIG_FILE"
+        return 1
+    fi
+    return 0
+}
+
+# Test API Gateway endpoints
+test_api_gateway() {
+    print_header
+    echo -e "${CYAN}🧪 API Gateway Test Suite${NC}"
+    print_header
+    
+    local base_url="http://localhost:3100"
+    local passed=0
+    local failed=0
+    
+    # Test health endpoint
+    echo -e "\n${BLUE}Testing endpoints:${NC}"
+    
+    local response
+    
+    # Health check
+    if response=$(curl -s "$base_url/health" 2>/dev/null); then
+        print_success "GET /health"
+        echo "  Response: $response"
+        passed=$((passed + 1))
+    else
+        print_error "GET /health - failed"
+        failed=$((failed + 1))
+    fi
+    
+    # Quality summary
+    if response=$(curl -s "$base_url/api/quality/summary" 2>/dev/null); then
+        print_success "GET /api/quality/summary"
+        local issues
+        local gate
+        issues=$(echo "$response" | jq -r '.summary.totalIssues // "N/A"' 2>/dev/null || echo "N/A")
+        gate=$(echo "$response" | jq -r '.summary.qualityGate // "N/A"' 2>/dev/null || echo "N/A")
+        echo "  Issues: $issues"
+        echo "  Quality Gate: $gate"
+        passed=$((passed + 1))
+    else
+        print_error "GET /api/quality/summary - failed"
+        failed=$((failed + 1))
+    fi
+    
+    # SonarCloud status
+    if curl -s "$base_url/api/sonarcloud/status" > /dev/null 2>&1; then
+        print_success "GET /api/sonarcloud/status"
+        passed=$((passed + 1))
+    else
+        print_error "GET /api/sonarcloud/status - failed"
+        failed=$((failed + 1))
+    fi
+    
+    # Cache stats
+    if response=$(curl -s "$base_url/api/cache/stats" 2>/dev/null); then
+        print_success "GET /api/cache/stats"
+        local size
+        size=$(echo "$response" | jq -r '.size // 0' 2>/dev/null || echo "0")
+        echo "  Cache size: $size"
+        passed=$((passed + 1))
+    else
+        print_error "GET /api/cache/stats - failed"
+        failed=$((failed + 1))
+    fi
+    
+    # Crawl4AI health
+    if response=$(curl -s "$base_url/api/crawl4ai/health" 2>/dev/null); then
+        local status
+        status=$(echo "$response" | jq -r '.status // "unknown"' 2>/dev/null || echo "unknown")
+        if [[ "$status" == "healthy" ]]; then
+            print_success "GET /api/crawl4ai/health - $status"
+        else
+            print_warning "GET /api/crawl4ai/health - $status (Crawl4AI may not be running)"
+        fi
+        passed=$((passed + 1))
+    else
+        print_error "GET /api/crawl4ai/health - failed"
+        failed=$((failed + 1))
+    fi
+    
+    echo ""
+    print_header
+    echo -e "Results: ${GREEN}$passed passed${NC} / ${RED}$failed failed${NC}"
+    return 0
+}
+
+# Show help
+show_help() {
+    cat << 'HELP'
+MCP Inspector Helper Script
+━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Usage: ./mcp-inspector-helper.sh [command] [options]
+
+Commands:
+  ui [server]              Launch web UI for interactive testing
+                           Opens browser at http://localhost:6274
+  
+  list-tools [server]      List available tools from server(s)
+                           If no server specified, lists from all
+  
+  call-tool <server> <tool> [args...]
+                           Call a specific tool with arguments
+                           Example: call-tool context7 resolve-library-id libraryName=react
+  
+  list-resources [server]  List available resources from server(s)
+  
+  health                   Check health of all configured servers
+  
+  test-gateway             Run API Gateway test suite
+  
+  config                   Show current MCP configuration
+  
+  help                     Show this help message
+
+Examples:
+  # Launch web UI for all servers
+  ./mcp-inspector-helper.sh ui
+  
+  # Launch web UI for specific server
+  ./mcp-inspector-helper.sh ui context7
+  
+  # List tools from Context7 server
+  ./mcp-inspector-helper.sh list-tools context7
+  
+  # Call a tool
+  ./mcp-inspector-helper.sh call-tool context7 resolve-library-id libraryName=bun
+  
+  # Health check all servers
+  ./mcp-inspector-helper.sh health
+  
+  # Test API Gateway
+  ./mcp-inspector-helper.sh test-gateway
+
+Configuration:
+  Config file: .opencode/server/mcp-test-config.json
+  
+  Servers defined:
+    - api-gateway      (HTTP)  - AI DevOps API Gateway
+    - mcp-dashboard    (HTTP)  - MCP Dashboard with WebSocket
+    - crawl4ai         (stdio) - Web crawling
+    - context7         (stdio) - Library documentation
+    - repomix          (stdio) - Repository packaging
+    - filesystem       (stdio) - File system access
+    - memory           (stdio) - Persistent memory
+    - github           (stdio) - GitHub API
+
+Starting Local Servers:
+  # Start API Gateway (port 3100)
+  bun run .opencode/server/api-gateway.ts
+  
+  # Start MCP Dashboard (port 3101)
+  bun run .opencode/server/mcp-dashboard.ts
+  
+  # Or use npm scripts
+  bun run dev        # API Gateway
+  bun run dashboard  # MCP Dashboard
+
+HELP
+    return 0
+}
+
+# Main
+main() {
+    check_inspector || exit 1
+    
+    local command="${1:-help}"
+    shift || true
+    
+    case "$command" in
+        ui|web)
+            launch_ui "$@"
+            ;;
+        list-tools|tools)
+            list_tools "$@"
+            ;;
+        call-tool|call)
+            call_tool "$@"
+            ;;
+        list-resources|resources)
+            list_resources "$@"
+            ;;
+        health|status)
+            health_check
+            ;;
+        test-gateway|test)
+            test_api_gateway
+            ;;
+        config|show-config)
+            show_config
+            ;;
+        help|--help|-h)
+            show_help
+            ;;
+        *)
+            print_error "Unknown command: $command"
+            echo "Run './mcp-inspector-helper.sh help' for usage"
+            return 1
+            ;;
+    esac
+    return 0
+}
+
+main "$@"