skill-seekers-reference/setup_mcp.sh

#!/bin/bash
# Skill Seeker MCP Server - Multi-Agent Auto-Configuration Setup
# This script detects installed AI agents and configures them automatically

set -e  # Exit on error

echo "=========================================================="
echo "Skill Seeker MCP Server - Multi-Agent Auto-Configuration"
echo "=========================================================="
echo ""

# Colors for output
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color

# Global variables
REPO_PATH=$(pwd)
PIP_INSTALL_CMD=""
HTTP_PORT=3000
HTTP_AGENTS=()
STDIO_AGENTS=()
SELECTED_AGENTS=()

# =============================================================================
# STEP 1: CHECK PYTHON VERSION
# =============================================================================
echo "Step 1: Checking Python version..."
if ! command -v python3 &> /dev/null; then
    echo -e "${RED}❌ Error: python3 not found${NC}"
    echo "Please install Python 3.10 or higher"
    exit 1
fi

PYTHON_VERSION=$(python3 --version | cut -d' ' -f2)
PYTHON_MAJOR=$(echo $PYTHON_VERSION | cut -d'.' -f1)
PYTHON_MINOR=$(echo $PYTHON_VERSION | cut -d'.' -f2)

if [ "$PYTHON_MAJOR" -lt 3 ] || ([ "$PYTHON_MAJOR" -eq 3 ] && [ "$PYTHON_MINOR" -lt 10 ]); then
    echo -e "${YELLOW}⚠ Warning: Python 3.10+ recommended for best compatibility${NC}"
    echo "Current version: $PYTHON_VERSION"
    echo ""
    read -p "Continue anyway? (y/n) " -n 1 -r
    echo ""
    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
        exit 1
    fi
else
    echo -e "${GREEN}✓${NC} Python $PYTHON_VERSION found"
fi
echo ""

# =============================================================================
# STEP 2: GET REPOSITORY PATH
# =============================================================================
echo "Step 2: Repository location"
echo "Path: $REPO_PATH"
echo ""

# =============================================================================
# STEP 3: INSTALL DEPENDENCIES
# =============================================================================
echo "Step 3: Installing Python dependencies..."

# Check if we're in a virtual environment
if [[ -n "$VIRTUAL_ENV" ]]; then
    echo -e "${GREEN}✓${NC} Virtual environment detected: $VIRTUAL_ENV"
    PIP_INSTALL_CMD="pip install"
elif [[ -d "venv" ]]; then
    echo -e "${YELLOW}⚠${NC} Virtual environment found but not activated"
    echo "Activating venv..."
    source venv/bin/activate
    PIP_INSTALL_CMD="pip install"
else
    echo -e "${YELLOW}⚠${NC} No virtual environment found"
    echo "It's recommended to use a virtual environment to avoid conflicts."
    echo ""
    read -p "Would you like to create one now? (y/n) " -n 1 -r
    echo ""

    if [[ $REPLY =~ ^[Yy]$ ]]; then
        echo "Creating virtual environment..."
        python3 -m venv venv || {
            echo -e "${RED}❌ Failed to create virtual environment${NC}"
            echo "Falling back to system install..."
            PIP_INSTALL_CMD="pip3 install --user --break-system-packages"
        }

        if [[ -d "venv" ]]; then
            source venv/bin/activate
            PIP_INSTALL_CMD="pip install"
            echo -e "${GREEN}✓${NC} Virtual environment created and activated"
        fi
    else
        echo "Proceeding with system install (using --user --break-system-packages)..."
        echo -e "${YELLOW}Note:${NC} This may override system-managed packages"
        PIP_INSTALL_CMD="pip3 install --user --break-system-packages"
    fi
fi

echo "This will install: mcp, fastmcp, requests, beautifulsoup4, uvicorn (for HTTP support)"
read -p "Continue? (y/n) " -n 1 -r
echo ""

if [[ $REPLY =~ ^[Yy]$ ]]; then
    echo "Installing package in editable mode..."
    $PIP_INSTALL_CMD -e . || {
        echo -e "${RED}❌ Failed to install package${NC}"
        exit 1
    }

    echo -e "${GREEN}✓${NC} Dependencies installed successfully"
else
    echo "Skipping dependency installation"
fi
echo ""

# =============================================================================
# STEP 4: TEST MCP SERVER (BOTH STDIO AND HTTP)
# =============================================================================
echo "Step 4: Testing MCP server..."

# Test stdio mode
echo "  Testing stdio transport..."
timeout 3 python3 -m skill_seekers.mcp.server_fastmcp 2>/dev/null || {
    if [ $? -eq 124 ]; then
        echo -e "  ${GREEN}✓${NC} Stdio transport working"
    else
        echo -e "  ${YELLOW}⚠${NC} Stdio test inconclusive, but may still work"
    fi
}

# Test HTTP mode
echo "  Testing HTTP transport..."
# Check if uvicorn is available
if python3 -c "import uvicorn" 2>/dev/null; then
    # Start HTTP server in background
    python3 -m skill_seekers.mcp.server_fastmcp --http --port 8765 > /dev/null 2>&1 &
    HTTP_TEST_PID=$!
    sleep 2

    # Test health endpoint
    if curl -s http://127.0.0.1:8765/health > /dev/null 2>&1; then
        echo -e "  ${GREEN}✓${NC} HTTP transport working (port 8765)"
        HTTP_AVAILABLE=true
    else
        echo -e "  ${YELLOW}⚠${NC} HTTP transport test failed (may need manual check)"
        HTTP_AVAILABLE=false
    fi

    # Cleanup
    kill $HTTP_TEST_PID 2>/dev/null || true
else
    echo -e "  ${YELLOW}⚠${NC} uvicorn not installed (HTTP transport unavailable)"
    echo "  Install with: $PIP_INSTALL_CMD uvicorn"
    HTTP_AVAILABLE=false
fi
echo ""

# =============================================================================
# STEP 5: DETECT INSTALLED AI AGENTS
# =============================================================================
echo "Step 5: Detecting installed AI coding agents..."
echo ""

# Use Python agent detector
DETECTED_AGENTS=$(python3 -c "
import sys
sys.path.insert(0, 'src')
from skill_seekers.mcp.agent_detector import AgentDetector
detector = AgentDetector()
agents = detector.detect_agents()
if agents:
    for agent in agents:
        print(f\"{agent['agent']}|{agent['name']}|{agent['config_path']}|{agent['transport']}\")
else:
    print('NONE')
" 2>/dev/null || echo "ERROR")

if [ "$DETECTED_AGENTS" = "ERROR" ]; then
    echo -e "${RED}❌ Error: Failed to run agent detector${NC}"
    echo "Falling back to manual configuration..."
    DETECTED_AGENTS="NONE"
fi

# Parse detected agents
if [ "$DETECTED_AGENTS" = "NONE" ]; then
    echo -e "${YELLOW}No AI coding agents detected.${NC}"
    echo ""
    echo "Supported agents:"
    echo "  • Claude Code (stdio)"
    echo "  • Cursor (HTTP)"
    echo "  • Windsurf (HTTP)"
    echo "  • VS Code + Cline extension (stdio)"
    echo "  • IntelliJ IDEA (HTTP)"
    echo ""
    echo "Manual configuration will be shown at the end."
else
    echo -e "${GREEN}Detected AI coding agents:${NC}"
    echo ""

    # Display detected agents
    IFS=$'\n'
    for agent_line in $DETECTED_AGENTS; do
        IFS='|' read -r agent_id agent_name config_path transport <<< "$agent_line"

        if [ "$transport" = "http" ]; then
            HTTP_AGENTS+=("$agent_id|$agent_name|$config_path")
            echo -e "  ${CYAN}✓${NC} $agent_name (HTTP transport)"
        else
            STDIO_AGENTS+=("$agent_id|$agent_name|$config_path")
            echo -e "  ${CYAN}✓${NC} $agent_name (stdio transport)"
        fi
        echo "    Config: $config_path"
    done
    unset IFS
fi
echo ""

# =============================================================================
# STEP 6: AUTO-CONFIGURE DETECTED AGENTS
# =============================================================================
if [ "$DETECTED_AGENTS" != "NONE" ]; then
    echo "Step 6: Configure detected agents"
    echo "=================================================="
    echo ""

    # Ask which agents to configure
    echo "Which agents would you like to configure?"
    echo ""
    echo "  1. All detected agents (recommended)"
    echo "  2. Select individual agents"
    echo "  3. Skip auto-configuration (manual setup)"
    echo ""
    read -p "Choose option (1-3): " -n 1 -r
    echo ""
    echo ""

    CONFIGURE_ALL=false
    CONFIGURE_SELECT=false

    case $REPLY in
        1)
            CONFIGURE_ALL=true
            echo "Configuring all detected agents..."
            ;;
        2)
            CONFIGURE_SELECT=true
            echo "Select agents to configure:"
            ;;
        3)
            echo "Skipping auto-configuration"
            echo "Manual configuration instructions will be shown at the end."
            ;;
        *)
            echo "Invalid option. Skipping auto-configuration."
            ;;
    esac
    echo ""

    # Build selection list
    if [ "$CONFIGURE_ALL" = true ] || [ "$CONFIGURE_SELECT" = true ]; then
        # Combine all agents
        ALL_AGENTS=("${STDIO_AGENTS[@]}" "${HTTP_AGENTS[@]}")

        if [ "$CONFIGURE_ALL" = true ]; then
            SELECTED_AGENTS=("${ALL_AGENTS[@]}")
        else
            # Individual selection
            for agent_line in "${ALL_AGENTS[@]}"; do
                IFS='|' read -r agent_id agent_name config_path <<< "$agent_line"
                read -p "  Configure $agent_name? (y/n) " -n 1 -r
                echo ""
                if [[ $REPLY =~ ^[Yy]$ ]]; then
                    SELECTED_AGENTS+=("$agent_line")
                fi
            done
            unset IFS
            echo ""
        fi

        # Configure selected agents
        if [ ${#SELECTED_AGENTS[@]} -eq 0 ]; then
            echo "No agents selected for configuration."
        else
            echo "Configuring ${#SELECTED_AGENTS[@]} agent(s)..."
            echo ""

            # Check if HTTP transport needed
            NEED_HTTP=false
            for agent_line in "${SELECTED_AGENTS[@]}"; do
                IFS='|' read -r agent_id agent_name config_path <<< "$agent_line"

                # Check if this is an HTTP agent
                for http_agent in "${HTTP_AGENTS[@]}"; do
                    if [ "$agent_line" = "$http_agent" ]; then
                        NEED_HTTP=true
                        break 2
                    fi
                done
            done
            unset IFS

            # Configure HTTP port if needed
            if [ "$NEED_HTTP" = true ]; then
                echo "HTTP transport required for some agents."
                read -p "Enter HTTP server port [default: 3000]: " PORT_INPUT
                if [ -n "$PORT_INPUT" ]; then
                    HTTP_PORT=$PORT_INPUT
                fi
                echo "Using port: $HTTP_PORT"
                echo ""
            fi

            # Configure each selected agent
            for agent_line in "${SELECTED_AGENTS[@]}"; do
                IFS='|' read -r agent_id agent_name config_path <<< "$agent_line"

                echo "Configuring $agent_name..."

                # Check if config already exists
                if [ -f "$config_path" ]; then
                    echo -e "  ${YELLOW}⚠ Config file already exists${NC}"

                    # Create backup
                    BACKUP_PATH="${config_path}.backup.$(date +%Y%m%d_%H%M%S)"
                    cp "$config_path" "$BACKUP_PATH"
                    echo -e "  ${GREEN}✓${NC} Backup created: $BACKUP_PATH"

                    # Check if skill-seeker already configured
                    if grep -q "skill-seeker" "$config_path" 2>/dev/null; then
                        echo -e "  ${YELLOW}⚠ skill-seeker already configured${NC}"
                        read -p "  Overwrite existing skill-seeker config? (y/n) " -n 1 -r
                        echo ""
                        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
                            echo "  Skipping $agent_name"
                            continue
                        fi
                    fi
                fi

                # Generate config using Python
                GENERATED_CONFIG=$(python3 -c "
import sys
sys.path.insert(0, 'src')
from skill_seekers.mcp.agent_detector import AgentDetector
detector = AgentDetector()

# Determine server command based on install type
if '$VIRTUAL_ENV':
    server_command = 'python -m skill_seekers.mcp.server_fastmcp'
else:
    server_command = 'skill-seekers mcp'

config = detector.generate_config('$agent_id', server_command, $HTTP_PORT)
print(config)
" 2>/dev/null)

                if [ -n "$GENERATED_CONFIG" ]; then
                    # Create parent directory if needed
                    mkdir -p "$(dirname "$config_path")"

                    # Write or merge configuration
                    if [ -f "$config_path" ]; then
                        # Merge with existing config
                        python3 -c "
import sys
import json
sys.path.insert(0, 'src')

# Read existing config
try:
    with open('$config_path', 'r') as f:
        existing = json.load(f)
except:
    existing = {}

# Parse new config
new = json.loads('''$GENERATED_CONFIG''')

# Merge (add skill-seeker, preserve others)
if 'mcpServers' not in existing:
    existing['mcpServers'] = {}
existing['mcpServers']['skill-seeker'] = new['mcpServers']['skill-seeker']

# Write back
with open('$config_path', 'w') as f:
    json.dump(existing, f, indent=2)
" 2>/dev/null || {
                            echo -e "  ${RED}✗${NC} Failed to merge config"
                            continue
                        }
                        echo -e "  ${GREEN}✓${NC} Merged with existing config"
                    else
                        # Write new config
                        echo "$GENERATED_CONFIG" > "$config_path"
                        echo -e "  ${GREEN}✓${NC} Config created"
                    fi

                    echo "  Location: $config_path"
                else
                    echo -e "  ${RED}✗${NC} Failed to generate config"
                fi
                echo ""
            done
            unset IFS
        fi
    fi
else
    echo "Step 6: Auto-configuration skipped (no agents detected)"
    echo ""
fi

# =============================================================================
# STEP 7: START HTTP SERVER (IF NEEDED)
# =============================================================================
if [ ${#SELECTED_AGENTS[@]} -gt 0 ]; then
    # Check if any selected agent needs HTTP
    NEED_HTTP_SERVER=false
    for agent_line in "${SELECTED_AGENTS[@]}"; do
        for http_agent in "${HTTP_AGENTS[@]}"; do
            if [ "$agent_line" = "$http_agent" ]; then
                NEED_HTTP_SERVER=true
                break 2
            fi
        done
    done

    if [ "$NEED_HTTP_SERVER" = true ]; then
        echo "Step 7: HTTP Server Setup"
        echo "=================================================="
        echo ""
        echo "Some configured agents require HTTP transport."
        echo "The MCP server needs to run in HTTP mode on port $HTTP_PORT."
        echo ""
        echo "Options:"
        echo "  1. Start server now (background process)"
        echo "  2. Show manual start command (start later)"
        echo "  3. Skip (I'll manage it myself)"
        echo ""
        read -p "Choose option (1-3): " -n 1 -r
        echo ""
        echo ""

        case $REPLY in
            1)
                echo "Starting HTTP server on port $HTTP_PORT..."

                # Start server in background
                nohup python3 -m skill_seekers.mcp.server_fastmcp --http --port $HTTP_PORT > /tmp/skill-seekers-mcp.log 2>&1 &
                SERVER_PID=$!

                sleep 2

                # Check if server started
                if curl -s http://127.0.0.1:$HTTP_PORT/health > /dev/null 2>&1; then
                    echo -e "${GREEN}✓${NC} HTTP server started (PID: $SERVER_PID)"
                    echo "  Health check: http://127.0.0.1:$HTTP_PORT/health"
                    echo "  Logs: /tmp/skill-seekers-mcp.log"
                    echo ""
                    echo -e "${YELLOW}Note:${NC} Server is running in background. To stop:"
                    echo "  kill $SERVER_PID"
                else
                    echo -e "${RED}✗${NC} Failed to start HTTP server"
                    echo "  Check logs: /tmp/skill-seekers-mcp.log"
                fi
                ;;
            2)
                echo "Manual start command:"
                echo ""
                echo -e "${GREEN}python3 -m skill_seekers.mcp.server_fastmcp --http --port $HTTP_PORT${NC}"
                echo ""
                echo "Or run in background:"
                echo -e "${GREEN}nohup python3 -m skill_seekers.mcp.server_fastmcp --http --port $HTTP_PORT > /tmp/skill-seekers-mcp.log 2>&1 &${NC}"
                ;;
            3)
                echo "Skipping HTTP server start"
                ;;
        esac
        echo ""
    else
        echo "Step 7: HTTP Server not needed (all agents use stdio)"
        echo ""
    fi
else
    echo "Step 7: HTTP Server setup skipped"
    echo ""
fi

# =============================================================================
# STEP 8: TEST CONFIGURATION
# =============================================================================
echo "Step 8: Testing Configuration"
echo "=================================================="
echo ""

if [ ${#SELECTED_AGENTS[@]} -gt 0 ]; then
    echo "Configured agents:"
    for agent_line in "${SELECTED_AGENTS[@]}"; do
        IFS='|' read -r agent_id agent_name config_path <<< "$agent_line"

        if [ -f "$config_path" ]; then
            echo -e "  ${GREEN}✓${NC} $agent_name"
            echo "    Config: $config_path"

            # Validate config file
            if command -v jq &> /dev/null; then
                if jq empty "$config_path" 2>/dev/null; then
                    echo -e "    ${GREEN}✓${NC} Valid JSON"
                else
                    echo -e "    ${RED}✗${NC} Invalid JSON"
                fi
            fi
        else
            echo -e "  ${RED}✗${NC} $agent_name (config not found)"
        fi
    done
    unset IFS
else
    echo "No agents configured. Manual configuration required."
fi
echo ""

# =============================================================================
# STEP 9: FINAL INSTRUCTIONS
# =============================================================================
echo "=========================================================="
echo "Setup Complete!"
echo "=========================================================="
echo ""

if [ ${#SELECTED_AGENTS[@]} -gt 0 ]; then
    echo -e "${GREEN}Next Steps:${NC}"
    echo ""
    echo "1. ${YELLOW}Restart your AI coding agent(s)${NC}"
    echo "   (Completely quit and reopen, don't just close window)"
    echo ""
    echo "2. ${YELLOW}Test the integration${NC}"
    echo "   Try commands like:"
    echo "   • ${CYAN}List all available configs${NC}"
    echo "   • ${CYAN}Generate config for React at https://react.dev${NC}"
    echo "   • ${CYAN}Estimate pages for configs/godot.json${NC}"
    echo ""

    # HTTP-specific instructions
    if [ "$NEED_HTTP_SERVER" = true ]; then
        echo "3. ${YELLOW}HTTP Server${NC}"
        echo "   Make sure HTTP server is running on port $HTTP_PORT"
        echo "   Test with: ${CYAN}curl http://127.0.0.1:$HTTP_PORT/health${NC}"
        echo ""
    fi
else
    echo -e "${YELLOW}Manual Configuration Required${NC}"
    echo ""
    echo "No agents were auto-configured. Here are configuration examples:"
    echo ""

    # Show stdio example
    echo "${CYAN}For Claude Code (stdio):${NC}"
    echo "File: ~/.config/claude-code/mcp.json"
    echo ""
    echo -e "${GREEN}{"
    echo "  \"mcpServers\": {"
    echo "    \"skill-seeker\": {"
    echo "      \"command\": \"python3\","
    echo "      \"args\": ["
    echo "        \"$REPO_PATH/src/skill_seekers/mcp/server_fastmcp.py\""
    echo "      ],"
    echo "      \"cwd\": \"$REPO_PATH\""
    echo "    }"
    echo "  }"
    echo -e "}${NC}"
    echo ""

    # Show HTTP example if available
    if [ "$HTTP_AVAILABLE" = true ]; then
        echo "${CYAN}For Cursor/Windsurf (HTTP):${NC}"
        echo ""
        echo "1. Start HTTP server:"
        echo "   ${GREEN}python3 -m skill_seekers.mcp.server_fastmcp --http --port 3000${NC}"
        echo ""
        echo "2. Add to agent config:"
        echo -e "${GREEN}{"
        echo "  \"mcpServers\": {"
        echo "    \"skill-seeker\": {"
        echo "      \"url\": \"http://localhost:3000/sse\""
        echo "    }"
        echo "  }"
        echo -e "}${NC}"
        echo ""
    fi
fi

echo "=========================================================="
echo "Available MCP Tools (17 total):"
echo "=========================================================="
echo ""
echo "${CYAN}Config Tools:${NC}"
echo "  • generate_config    - Create config files for any docs site"
echo "  • list_configs       - Show all available preset configs"
echo "  • validate_config    - Validate config file structure"
echo ""
echo "${CYAN}Scraping Tools:${NC}"
echo "  • estimate_pages     - Estimate page count before scraping"
echo "  • scrape_docs        - Scrape documentation and build skills"
echo "  • scrape_github      - Scrape GitHub repositories"
echo "  • scrape_pdf         - Extract content from PDF files"
echo ""
echo "${CYAN}Packaging Tools:${NC}"
echo "  • package_skill      - Package skills into .zip files"
echo "  • upload_skill       - Upload skills to Claude"
echo "  • install_skill      - Install uploaded skills"
echo ""
echo "${CYAN}Splitting Tools:${NC}"
echo "  • split_config       - Split large documentation configs"
echo "  • generate_router    - Generate router/hub skills"
echo ""
echo "${CYAN}Config Source Tools (NEW):${NC}"
echo "  • fetch_config       - Download configs from remote sources"
echo "  • submit_config      - Submit configs to community"
echo "  • add_config_source  - Add custom config sources"
echo "  • list_config_sources - Show available config sources"
echo "  • remove_config_source - Remove config sources"
echo ""

echo "=========================================================="
echo "Documentation:"
echo "=========================================================="
echo "  • MCP Setup Guide:     ${YELLOW}docs/MCP_SETUP.md${NC}"
echo "  • HTTP Transport:      ${YELLOW}docs/HTTP_TRANSPORT.md${NC}"
echo "  • Agent Detection:     ${YELLOW}src/skill_seekers/mcp/agent_detector.py${NC}"
echo "  • Full Documentation:  ${YELLOW}README.md${NC}"
echo ""

echo "=========================================================="
echo "Troubleshooting:"
echo "=========================================================="
echo "  • Agent logs:"
echo "    - Claude Code: ~/Library/Logs/Claude Code/ (macOS)"
echo "    - Cursor: ~/.cursor/logs/"
echo "    - VS Code: ~/.config/Code/logs/"
echo ""
echo "  • Test MCP server:"
echo "    ${CYAN}python3 -m skill_seekers.mcp.server_fastmcp${NC}"
echo ""
echo "  • Test HTTP server:"
echo "    ${CYAN}python3 -m skill_seekers.mcp.server_fastmcp --http${NC}"
echo "    ${CYAN}curl http://127.0.0.1:8000/health${NC}"
echo ""
echo "  • Run tests:"
echo "    ${CYAN}pytest tests/test_mcp_server.py -v${NC}"
echo ""
echo "  • View server logs (if HTTP):"
echo "    ${CYAN}tail -f /tmp/skill-seekers-mcp.log${NC}"
echo ""

echo "Happy skill creating! 🚀"
echo ""