KiCAD-MCP-Server

#!/bin/bash # KiCAD MCP Server - Linux Installation Script # Supports Ubuntu/Debian-based distributions set -e # Exit on error # Colors for output RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m' # No Color # Print colored messages print_info() { echo -e "${BLUE}ℹ${NC} $1"; } print_success() { echo -e "${GREEN}✓${NC} $1"; } print_warning() { echo -e "${YELLOW}⚠${NC} $1"; } print_error() { echo -e "${RED}✗${NC} $1"; } # Header echo "" echo "╔═══════════════════════════════════════════════════════════════╗" echo "║ KiCAD MCP Server - Linux Installation ║" echo "║ ║" echo "║ This script will install: ║" echo "║ - KiCAD 9.0 ║" echo "║ - Node.js 20.x ║" echo "║ - Python dependencies ║" echo "║ - Build the TypeScript server ║" echo "╚═══════════════════════════════════════════════════════════════╝" echo "" # Check if running on Linux if [[ "$OSTYPE" != "linux-gnu"* ]]; then print_error "This script is for Linux only. Detected: $OSTYPE" exit 1 fi # Check for Ubuntu/Debian if ! command -v apt-get &> /dev/null; then print_warning "This script is optimized for Ubuntu/Debian" print_warning "For other distributions, please install manually" read -p "Continue anyway? (y/N) " -n 1 -r echo if [[ ! $REPLY =~ ^[Yy]$ ]]; then exit 1 fi fi # Function to check if command exists command_exists() { command -v "$1" &> /dev/null } # Step 1: Install KiCAD 9.0 print_info "Step 1/5: Installing KiCAD 9.0..." if command_exists kicad; then KICAD_VERSION=$(kicad-cli version 2>/dev/null | head -n 1 || echo "unknown") print_success "KiCAD is already installed: $KICAD_VERSION" else print_info "Adding KiCAD PPA and installing..." sudo add-apt-repository --yes ppa:kicad/kicad-9.0-releases sudo apt-get update sudo apt-get install -y kicad kicad-libraries print_success "KiCAD 9.0 installed" fi # Verify KiCAD Python module print_info "Verifying KiCAD Python module..." if python3 -c "import pcbnew; print(pcbnew.GetBuildVersion())" 2>/dev/null; then PCBNEW_VERSION=$(python3 -c "import pcbnew; print(pcbnew.GetBuildVersion())") print_success "KiCAD Python module (pcbnew) found: $PCBNEW_VERSION" else print_warning "KiCAD Python module (pcbnew) not found in default Python path" print_warning "You may need to set PYTHONPATH manually" fi # Step 2: Install Node.js print_info "Step 2/5: Installing Node.js 20.x..." if command_exists node; then NODE_VERSION=$(node --version) MAJOR_VERSION=$(echo $NODE_VERSION | cut -d'.' -f1 | sed 's/v//') if [ "$MAJOR_VERSION" -ge 18 ]; then print_success "Node.js is already installed: $NODE_VERSION" else print_warning "Node.js version is too old: $NODE_VERSION (need 18+)" print_info "Installing Node.js 20.x..." curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs print_success "Node.js updated" fi else print_info "Installing Node.js 20.x..." curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs print_success "Node.js installed: $(node --version)" fi # Step 3: Install Python dependencies print_info "Step 3/5: Installing Python dependencies..." if [ -f "requirements.txt" ]; then pip3 install --user -r requirements.txt print_success "Python dependencies installed" else print_warning "requirements.txt not found - skipping Python dependencies" fi # Step 4: Install Node.js dependencies print_info "Step 4/5: Installing Node.js dependencies..." if [ -f "package.json" ]; then npm install print_success "Node.js dependencies installed" else print_error "package.json not found! Are you in the correct directory?" exit 1 fi # Step 5: Build TypeScript print_info "Step 5/5: Building TypeScript..." npm run build print_success "TypeScript build complete" # Final checks echo "" print_info "Running final checks..." # Check if dist directory was created if [ -d "dist" ]; then print_success "dist/ directory created" else print_error "dist/ directory not found - build may have failed" exit 1 fi # Test platform helper print_info "Testing platform detection..." if python3 python/utils/platform_helper.py > /dev/null 2>&1; then print_success "Platform helper working" else print_warning "Platform helper test failed" fi # Installation complete echo "" echo "╔═══════════════════════════════════════════════════════════════╗" echo "║ 🎉 Installation Complete! 🎉 ║" echo "╚═══════════════════════════════════════════════════════════════╝" echo "" print_success "KiCAD MCP Server is ready to use!" echo "" print_info "Next steps:" echo " 1. Configure Cline in VSCode with the path to dist/index.js" echo " 2. Set PYTHONPATH in Cline config (see README.md)" echo " 3. Restart VSCode" echo " 4. Test with: 'Create a new KiCAD project named TestProject'" echo "" print_info "For detailed configuration, see:" echo " - README.md (Linux section)" echo " - config/linux-config.example.json" echo "" print_info "To run tests:" echo " pytest tests/" echo "" print_info "Need help? Check docs/LINUX_COMPATIBILITY_AUDIT.md" echo ""