nodebench-mcp 2.15.0 → 2.17.0

package/dist/tools/metaTools.js

@@ -3,6 +3,17 @@
  * findTools helps agents discover what's available.
  * getMethodology teaches agents the development process.
  */
+import { createRequire } from "node:module";
+const _require = createRequire(import.meta.url);
+function _isInstalled(pkg) {
+    try {
+        _require.resolve(pkg);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 const METHODOLOGY_CONTENT = {
     verification: {
         title: "6-Phase Iterative Deep-Dive Verification Process",
@@ -1585,6 +1596,655 @@ export function createMetaTools(allTools) {
                 return content;
             },
         },
+        {
+            name: "check_mcp_setup",
+            description: "Comprehensive diagnostic wizard for the entire NodeBench MCP. Checks all env vars, API keys, optional npm packages, and external services across every domain. Returns a full readiness report with per-domain status and step-by-step setup instructions for anything missing. Run this FIRST to see what capabilities are available and what needs configuration.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    domains: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Specific domains to check (default: all). Options: web, vision, github, llm, embedding, email, flicker_detection, figma_flow, ui_capture, local_file, gaia_solvers",
+                    },
+                    test_connections: {
+                        type: "boolean",
+                        description: "Test reachability of Python servers (flicker on :8006, figma on :8007) and email SMTP/IMAP. Default: false",
+                    },
+                    generate_config: {
+                        type: "boolean",
+                        description: "Generate a complete MCP config snippet with all needed env vars (default: true)",
+                    },
+                    generate_setup: {
+                        type: "boolean",
+                        description: "Generate complete setup files that an agent can write to disk to self-enable every capability: .env.nodebench (env template), setup-nodebench.sh (bash), setup-nodebench.ps1 (powershell), docker-compose.nodebench.yml (Python servers). Default: false",
+                    },
+                },
+                required: [],
+            },
+            handler: async (args) => {
+                const testConnections = args.test_connections === true;
+                const generateConfig = args.generate_config !== false;
+                const generateSetup = args.generate_setup === true;
+                const targetDomains = args.domains;
+                const reports = [];
+                const envCheck = (name, hint) => {
+                    const val = process.env[name];
+                    return {
+                        item: name,
+                        status: val ? "ok" : "missing",
+                        value: val ? `${val.substring(0, 4)}***` : undefined,
+                        hint: !val ? hint : undefined,
+                    };
+                };
+                const anyEnv = (...names) => names.some((n) => !!process.env[n]);
+                const pkgCheck = (name) => ({
+                    item: `npm: ${name}`,
+                    status: _isInstalled(name) ? "installed" : "not_installed",
+                    hint: !_isInstalled(name) ? `npm install ${name}` : undefined,
+                });
+                const shouldCheck = (d) => !targetDomains || targetDomains.includes(d);
+                // ── WEB ──
+                if (shouldCheck("web")) {
+                    const checks = [
+                        envCheck("GEMINI_API_KEY", "Google AI key (free at https://aistudio.google.com/apikey)"),
+                        envCheck("OPENAI_API_KEY", "OpenAI key from https://platform.openai.com/api-keys"),
+                        envCheck("PERPLEXITY_API_KEY", "Perplexity key from https://www.perplexity.ai/settings/api"),
+                    ];
+                    const ok = anyEnv("GEMINI_API_KEY", "OPENAI_API_KEY", "PERPLEXITY_API_KEY");
+                    reports.push({
+                        domain: "web",
+                        ready: ok,
+                        status: ok ? "ready" : "not_configured",
+                        checks,
+                        tools: ["web_search", "fetch_url"],
+                        ...(!ok
+                            ? {
+                                setupInstructions: [
+                                    "web_search needs at least ONE LLM API key.",
+                                    "Easiest: Get a free Gemini key at https://aistudio.google.com/apikey",
+                                    "Set GEMINI_API_KEY=your-key in your MCP config env vars.",
+                                    "fetch_url works without any API keys (raw HTTP fetch).",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── VISION ──
+                if (shouldCheck("vision")) {
+                    const pw = _isInstalled("playwright");
+                    const checks = [
+                        envCheck("GEMINI_API_KEY", "Needed for LLM-based image analysis"),
+                        envCheck("OPENAI_API_KEY", "Alternative: OpenAI vision models"),
+                        pkgCheck("playwright"),
+                    ];
+                    const hasLlm = anyEnv("GEMINI_API_KEY", "OPENAI_API_KEY");
+                    reports.push({
+                        domain: "vision",
+                        ready: hasLlm,
+                        status: hasLlm ? (pw ? "ready" : "partial") : "not_configured",
+                        checks,
+                        tools: ["discover_vision_env", "analyze_screenshot", "manipulate_screenshot", "diff_screenshots"],
+                        ...(!hasLlm
+                            ? {
+                                setupInstructions: [
+                                    "Vision tools need an LLM API key for image analysis.",
+                                    "Set GEMINI_API_KEY or OPENAI_API_KEY.",
+                                    "Optional: npm install playwright && npx playwright install chromium",
+                                ],
+                            }
+                            : !pw
+                                ? {
+                                    setupInstructions: [
+                                        "Vision LLM analysis is ready.",
+                                        "Optional: npm install playwright && npx playwright install chromium (for browser screenshots)",
+                                    ],
+                                }
+                                : {}),
+                    });
+                }
+                // ── GITHUB ──
+                if (shouldCheck("github")) {
+                    const checks = [envCheck("GITHUB_TOKEN", "Fine-grained token from https://github.com/settings/tokens")];
+                    const ok = !!process.env.GITHUB_TOKEN;
+                    reports.push({
+                        domain: "github",
+                        ready: ok,
+                        status: ok ? "ready" : "not_configured",
+                        checks,
+                        tools: ["search_github", "analyze_repo", "monitor_repo"],
+                        ...(!ok
+                            ? {
+                                setupInstructions: [
+                                    "1. Go to https://github.com/settings/tokens",
+                                    "2. Generate fine-grained token with: Contents (read), Metadata (read)",
+                                    "3. Set GITHUB_TOKEN=ghp_your-token",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── LLM ──
+                if (shouldCheck("llm")) {
+                    const checks = [
+                        envCheck("ANTHROPIC_API_KEY", "From https://console.anthropic.com/settings/keys"),
+                        envCheck("OPENAI_API_KEY", "OpenAI key"),
+                        envCheck("GEMINI_API_KEY", "Google AI key (free tier)"),
+                    ];
+                    const ok = anyEnv("ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GEMINI_API_KEY");
+                    reports.push({
+                        domain: "llm",
+                        ready: ok,
+                        status: ok ? "ready" : "not_configured",
+                        checks,
+                        tools: ["call_llm", "extract_structured_data", "benchmark_models"],
+                        ...(!ok
+                            ? {
+                                setupInstructions: [
+                                    "call_llm needs at least ONE LLM API key.",
+                                    "ANTHROPIC_API_KEY (Claude), OPENAI_API_KEY (GPT), or GEMINI_API_KEY (Gemini, free).",
+                                    "Easiest: Get a free Gemini key at https://aistudio.google.com/apikey",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── EMBEDDING ──
+                if (shouldCheck("embedding")) {
+                    const hasHf = _isInstalled("@huggingface/transformers");
+                    const checks = [
+                        pkgCheck("@huggingface/transformers"),
+                        envCheck("GEMINI_API_KEY", "Fallback: Google text-embedding-004 (free)"),
+                        envCheck("OPENAI_API_KEY", "Fallback: OpenAI text-embedding-3-small"),
+                    ];
+                    const ok = hasHf || anyEnv("GEMINI_API_KEY", "OPENAI_API_KEY");
+                    reports.push({
+                        domain: "embedding",
+                        ready: ok,
+                        status: ok ? "ready" : "not_configured",
+                        checks,
+                        tools: ["discover_tools (semantic mode)"],
+                        ...(!ok
+                            ? {
+                                setupInstructions: [
+                                    "Embedding search enhances discover_tools with semantic understanding.",
+                                    "Option 1 (recommended, free, local): npm install @huggingface/transformers",
+                                    "  Uses Xenova/all-MiniLM-L6-v2 (23MB INT8, no API key needed)",
+                                    "Option 2: Set GEMINI_API_KEY (free Google text-embedding-004)",
+                                    "Option 3: Set OPENAI_API_KEY (OpenAI text-embedding-3-small, paid)",
+                                    "Without embedding, discover_tools still works with keyword/fuzzy search.",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── EMAIL ──
+                if (shouldCheck("email")) {
+                    const checks = [
+                        envCheck("EMAIL_USER", "Your email address (e.g., agent@gmail.com)"),
+                        envCheck("EMAIL_PASS", "App password (NOT regular password)"),
+                    ];
+                    const ok = !!process.env.EMAIL_USER && !!process.env.EMAIL_PASS;
+                    reports.push({
+                        domain: "email",
+                        ready: ok,
+                        status: ok ? "ready" : "not_configured",
+                        checks,
+                        tools: ["send_email", "read_emails", "draft_email_reply", "check_email_setup"],
+                        ...(!ok
+                            ? {
+                                setupInstructions: [
+                                    "For detailed per-provider setup, run check_email_setup instead.",
+                                    "Quick start (Gmail):",
+                                    "1. Enable 2FA at https://myaccount.google.com/security",
+                                    "2. Create app password at https://myaccount.google.com/apppasswords",
+                                    "3. Set EMAIL_USER=your.email@gmail.com",
+                                    "4. Set EMAIL_PASS=your-16-char-app-password",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── FLICKER DETECTION ──
+                if (shouldCheck("flicker_detection")) {
+                    const checks = [
+                        { item: "Python FastAPI server (port 8006)", status: "optional", hint: "docker compose up flicker_detection" },
+                    ];
+                    let serverOk = false;
+                    if (testConnections) {
+                        try {
+                            const res = await fetch("http://localhost:8006/health", { signal: AbortSignal.timeout(3000) });
+                            serverOk = res.ok;
+                            checks[0] = { item: "Python FastAPI server (port 8006)", status: serverOk ? "ok" : "missing", hint: serverOk ? "Server running" : "Not reachable" };
+                        }
+                        catch {
+                            checks[0] = { item: "Python FastAPI server (port 8006)", status: "missing", hint: "Not reachable. Start with: docker compose up flicker_detection" };
+                        }
+                    }
+                    reports.push({
+                        domain: "flicker_detection",
+                        ready: testConnections ? serverOk : true,
+                        status: testConnections ? (serverOk ? "ready" : "not_configured") : "partial",
+                        checks,
+                        tools: ["start_flicker_analysis", "get_flicker_status", "get_flicker_results", "compare_flicker_runs", "detect_flicker_frames"],
+                        setupInstructions: [
+                            "Flicker detection requires a Python FastAPI server:",
+                            "1. cd python-mcp-servers",
+                            "2. docker compose up flicker_detection",
+                            "3. Server starts on port 8006",
+                            "4. Requires ffmpeg installed on the server",
+                            "Run check_mcp_setup with test_connections=true to verify.",
+                        ],
+                    });
+                }
+                // ── FIGMA FLOW ──
+                if (shouldCheck("figma_flow")) {
+                    const checks = [
+                        envCheck("FIGMA_ACCESS_TOKEN", "From https://www.figma.com/developers/api#access-tokens"),
+                        { item: "Python FastAPI server (port 8007)", status: "optional", hint: "docker compose up figma_flow" },
+                    ];
+                    let serverOk = false;
+                    if (testConnections) {
+                        try {
+                            const res = await fetch("http://localhost:8007/health", { signal: AbortSignal.timeout(3000) });
+                            serverOk = res.ok;
+                            checks[1] = { item: "Python FastAPI server (port 8007)", status: serverOk ? "ok" : "missing" };
+                        }
+                        catch {
+                            checks[1] = { item: "Python FastAPI server (port 8007)", status: "missing", hint: "Not reachable. Start with: docker compose up figma_flow" };
+                        }
+                    }
+                    const hasToken = !!process.env.FIGMA_ACCESS_TOKEN;
+                    reports.push({
+                        domain: "figma_flow",
+                        ready: hasToken && (testConnections ? serverOk : true),
+                        status: hasToken ? (testConnections ? (serverOk ? "ready" : "partial") : "partial") : "not_configured",
+                        checks,
+                        tools: ["analyze_figma_flow", "get_figma_flow_status", "get_figma_flow_results", "compare_figma_flows"],
+                        ...(!hasToken
+                            ? {
+                                setupInstructions: [
+                                    "1. Go to https://www.figma.com/developers/api#access-tokens",
+                                    "2. Generate a personal access token",
+                                    "3. Set FIGMA_ACCESS_TOKEN=your-token",
+                                    "4. Start server: cd python-mcp-servers && docker compose up figma_flow (port 8007)",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── UI CAPTURE ──
+                if (shouldCheck("ui_capture")) {
+                    const pw = _isInstalled("playwright");
+                    reports.push({
+                        domain: "ui_capture",
+                        ready: pw,
+                        status: pw ? "ready" : "not_configured",
+                        checks: [pkgCheck("playwright")],
+                        tools: ["capture_ui_screenshot", "capture_responsive_suite"],
+                        ...(!pw
+                            ? {
+                                setupInstructions: [
+                                    "1. npm install playwright",
+                                    "2. npx playwright install chromium",
+                                    "Uses headless Chromium to screenshot URLs at multiple breakpoints.",
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── LOCAL FILE ──
+                if (shouldCheck("local_file")) {
+                    const deps = [
+                        { name: "cheerio", use: "HTML parsing" },
+                        { name: "pdf-parse", use: "PDF extraction" },
+                        { name: "xlsx", use: "Excel/CSV parsing" },
+                        { name: "sharp", use: "Image processing" },
+                        { name: "tesseract.js", use: "OCR (text from images)" },
+                        { name: "yauzl", use: "ZIP extraction" },
+                        { name: "papaparse", use: "CSV parsing" },
+                    ];
+                    const checks = deps.map((d) => ({
+                        ...pkgCheck(d.name),
+                        hint: _isInstalled(d.name) ? `Used for: ${d.use}` : `npm install ${d.name} (for: ${d.use})`,
+                    }));
+                    const count = deps.filter((d) => _isInstalled(d.name)).length;
+                    reports.push({
+                        domain: "local_file",
+                        ready: true,
+                        status: count === deps.length ? "ready" : count > 0 ? "partial" : "not_configured",
+                        checks,
+                        tools: ["parse_html_file", "parse_pdf_file", "parse_excel_file", "parse_csv_file", "ocr_image", "extract_zip", "read_local_file"],
+                        setupInstructions: [
+                            "Core file tools (read, stat, list) always work. Optional deps extend capabilities:",
+                            ...deps.filter((d) => !_isInstalled(d.name)).map((d) => `  npm install ${d.name} → ${d.use}`),
+                            deps.every((d) => _isInstalled(d.name))
+                                ? "All optional file deps installed!"
+                                : "Install all: npm install cheerio pdf-parse xlsx sharp tesseract.js yauzl papaparse",
+                        ],
+                    });
+                }
+                // ── GAIA SOLVERS ──
+                if (shouldCheck("gaia_solvers")) {
+                    const checks = [
+                        envCheck("HF_TOKEN", "Hugging Face token from https://huggingface.co/settings/tokens"),
+                        pkgCheck("sharp"),
+                        pkgCheck("tesseract.js"),
+                    ];
+                    const hasToken = !!process.env.HF_TOKEN;
+                    const hasDeps = _isInstalled("sharp") && _isInstalled("tesseract.js");
+                    reports.push({
+                        domain: "gaia_solvers",
+                        ready: hasToken && hasDeps,
+                        status: hasToken && hasDeps ? "ready" : hasToken || hasDeps ? "partial" : "not_configured",
+                        checks,
+                        tools: ["solve_red_green_deviation_average_from_image", "solve_green_polygon_area_from_image", "read_image_ocr_text", "count_shapes_in_image", "solve_chessboard_fen", "measure_angles_in_image"],
+                        ...(!hasToken || !hasDeps
+                            ? {
+                                setupInstructions: [
+                                    ...(!hasToken ? ["1. Get token at https://huggingface.co/settings/tokens", "2. Set HF_TOKEN=hf_your-token"] : []),
+                                    ...(!hasDeps ? ["3. npm install sharp tesseract.js"] : []),
+                                ],
+                            }
+                            : {}),
+                    });
+                }
+                // ── Summary ──
+                const readyCount = reports.filter((r) => r.ready).length;
+                const partialCount = reports.filter((r) => r.status === "partial").length;
+                const missingCount = reports.filter((r) => r.status === "not_configured").length;
+                // ── MCP config snippet ──
+                let configSnippet;
+                if (generateConfig) {
+                    const envVars = {};
+                    for (const report of reports) {
+                        for (const check of report.checks) {
+                            if (check.status === "missing" && !check.item.startsWith("npm:") && !check.item.includes("server")) {
+                                envVars[check.item] = check.hint || "your-value-here";
+                            }
+                        }
+                    }
+                    if (Object.keys(envVars).length > 0) {
+                        configSnippet = JSON.stringify({
+                            mcpServers: {
+                                nodebench: {
+                                    command: "npx",
+                                    args: ["-y", "nodebench-mcp"],
+                                    env: Object.fromEntries(Object.entries(envVars).map(([k, v]) => [k, process.env[k] || v])),
+                                },
+                            },
+                        }, null, 2);
+                    }
+                }
+                // ── Setup file generation ──
+                let setupFiles;
+                if (generateSetup) {
+                    // .env.nodebench — complete env var template
+                    const envTemplate = [
+                        "# ═══════════════════════════════════════════════════════════",
+                        "# NodeBench MCP — Environment Variables",
+                        "# Generated by check_mcp_setup. Fill in values and rename to .env",
+                        "# ═══════════════════════════════════════════════════════════",
+                        "",
+                        "# ── LLM / Web Search (at least ONE required) ──",
+                        `GEMINI_API_KEY=${process.env.GEMINI_API_KEY || ""}                  # Free at https://aistudio.google.com/apikey`,
+                        `OPENAI_API_KEY=${process.env.OPENAI_API_KEY || ""}                  # https://platform.openai.com/api-keys`,
+                        `ANTHROPIC_API_KEY=${process.env.ANTHROPIC_API_KEY || ""}            # https://console.anthropic.com/settings/keys`,
+                        `PERPLEXITY_API_KEY=${process.env.PERPLEXITY_API_KEY || ""}          # https://www.perplexity.ai/settings/api`,
+                        "",
+                        "# ── GitHub ──",
+                        `GITHUB_TOKEN=${process.env.GITHUB_TOKEN || ""}                      # Fine-grained: https://github.com/settings/tokens`,
+                        "",
+                        "# ── Email (SMTP/IMAP) ──",
+                        `EMAIL_USER=${process.env.EMAIL_USER || ""}                          # e.g. agent@gmail.com`,
+                        `EMAIL_PASS=${process.env.EMAIL_PASS || ""}                          # App password (NOT regular password)`,
+                        `EMAIL_SMTP_HOST=${process.env.EMAIL_SMTP_HOST || "smtp.gmail.com"}  # Default: smtp.gmail.com`,
+                        `EMAIL_SMTP_PORT=${process.env.EMAIL_SMTP_PORT || "465"}             # Default: 465 (TLS)`,
+                        `EMAIL_IMAP_HOST=${process.env.EMAIL_IMAP_HOST || "imap.gmail.com"}  # Default: imap.gmail.com`,
+                        `EMAIL_IMAP_PORT=${process.env.EMAIL_IMAP_PORT || "993"}             # Default: 993 (TLS)`,
+                        "",
+                        "# ── Figma ──",
+                        `FIGMA_ACCESS_TOKEN=${process.env.FIGMA_ACCESS_TOKEN || ""}          # https://www.figma.com/developers/api#access-tokens`,
+                        "",
+                        "# ── Hugging Face (GAIA solvers + local embeddings) ──",
+                        `HF_TOKEN=${process.env.HF_TOKEN || ""}                              # https://huggingface.co/settings/tokens`,
+                        "",
+                        "# ── Python servers (flicker detection + figma flow) ──",
+                        "# These are started via docker compose, not env vars.",
+                        "# See docker-compose.nodebench.yml for configuration.",
+                        "",
+                    ].join("\n");
+                    // setup-nodebench.sh — bash install script
+                    const bashScript = [
+                        "#!/usr/bin/env bash",
+                        "set -euo pipefail",
+                        "",
+                        "# ═══════════════════════════════════════════════════════════",
+                        "# NodeBench MCP — Setup Script (bash)",
+                        "# Generated by check_mcp_setup",
+                        "# ═══════════════════════════════════════════════════════════",
+                        "",
+                        'echo "=== NodeBench MCP Setup ==="',
+                        'echo ""',
+                        "",
+                        "# Step 1: Install required dependencies",
+                        'echo "→ Installing required npm packages..."',
+                        "npm install @modelcontextprotocol/sdk better-sqlite3 @toon-format/toon",
+                        "",
+                        "# Step 2: Install optional dependencies for extended capabilities",
+                        'echo "→ Installing optional dependencies..."',
+                        'echo "  These unlock: HTML parsing, PDF extraction, Excel/CSV, OCR, images, ZIP, browser screenshots"',
+                        "npm install cheerio pdf-parse xlsx sharp tesseract.js yauzl papaparse || true",
+                        "",
+                        "# Step 3: Install embedding provider (local semantic search)",
+                        'echo "→ Installing local embedding model..."',
+                        'echo "  Enables semantic search in discover_tools (23MB model, no API key needed)"',
+                        "npm install @huggingface/transformers || true",
+                        "",
+                        "# Step 4: Install Playwright for browser-based tools",
+                        'echo "→ Installing Playwright + Chromium..."',
+                        "npm install playwright || true",
+                        "npx playwright install chromium || true",
+                        "",
+                        "# Step 5: Install LLM SDKs",
+                        'echo "→ Installing LLM SDKs..."',
+                        "npm install @anthropic-ai/sdk @google/genai openai || true",
+                        "",
+                        "# Step 6: Set up Python servers (optional)",
+                        'echo ""',
+                        'echo "→ Python servers (flicker detection + figma flow):"',
+                        'echo "  If you need these, run: docker compose -f docker-compose.nodebench.yml up -d"',
+                        "",
+                        "# Step 7: Environment variables",
+                        'echo ""',
+                        'echo "=== Setup Complete ==="',
+                        'echo ""',
+                        'echo "Next steps:"',
+                        'echo "  1. Copy .env.nodebench to .env and fill in your API keys"',
+                        'echo "  2. Add env vars to your MCP config (Claude Code / Cursor / etc)"',
+                        'echo "  3. Run: npx nodebench-mcp --preset full"',
+                        'echo "  4. Verify: call check_mcp_setup to see all domains"',
+                        "",
+                    ].join("\n");
+                    // setup-nodebench.ps1 — PowerShell install script
+                    const psScript = [
+                        "# ═══════════════════════════════════════════════════════════",
+                        "# NodeBench MCP — Setup Script (PowerShell)",
+                        "# Generated by check_mcp_setup",
+                        "# ═══════════════════════════════════════════════════════════",
+                        "",
+                        '$ErrorActionPreference = "Continue"',
+                        "",
+                        'Write-Host "=== NodeBench MCP Setup ===" -ForegroundColor Cyan',
+                        'Write-Host ""',
+                        "",
+                        "# Step 1: Required dependencies",
+                        'Write-Host "-> Installing required npm packages..." -ForegroundColor Yellow',
+                        "npm install @modelcontextprotocol/sdk better-sqlite3 @toon-format/toon",
+                        "",
+                        "# Step 2: Optional dependencies",
+                        'Write-Host "-> Installing optional dependencies..." -ForegroundColor Yellow',
+                        "npm install cheerio pdf-parse xlsx sharp tesseract.js yauzl papaparse 2>$null",
+                        "",
+                        "# Step 3: Embedding provider",
+                        'Write-Host "-> Installing local embedding model..." -ForegroundColor Yellow',
+                        "npm install @huggingface/transformers 2>$null",
+                        "",
+                        "# Step 4: Playwright",
+                        'Write-Host "-> Installing Playwright + Chromium..." -ForegroundColor Yellow',
+                        "npm install playwright 2>$null",
+                        "npx playwright install chromium 2>$null",
+                        "",
+                        "# Step 5: LLM SDKs",
+                        'Write-Host "-> Installing LLM SDKs..." -ForegroundColor Yellow',
+                        "npm install @anthropic-ai/sdk @google/genai openai 2>$null",
+                        "",
+                        "# Step 6: Python servers",
+                        'Write-Host ""',
+                        'Write-Host "-> Python servers (flicker detection + figma flow):" -ForegroundColor Yellow',
+                        'Write-Host "  If needed: docker compose -f docker-compose.nodebench.yml up -d"',
+                        "",
+                        'Write-Host ""',
+                        'Write-Host "=== Setup Complete ===" -ForegroundColor Green',
+                        'Write-Host ""',
+                        'Write-Host "Next steps:"',
+                        'Write-Host "  1. Copy .env.nodebench to .env and fill in your API keys"',
+                        'Write-Host "  2. Add env vars to your MCP config (Claude Code / Cursor / etc)"',
+                        'Write-Host "  3. Run: npx nodebench-mcp --preset full"',
+                        'Write-Host "  4. Verify: call check_mcp_setup to see all domains"',
+                        "",
+                    ].join("\n");
+                    // docker-compose.nodebench.yml
+                    const dockerCompose = [
+                        "# ═══════════════════════════════════════════════════════════",
+                        "# NodeBench MCP — Docker Compose for Python Servers",
+                        "# Generated by check_mcp_setup",
+                        "# ═══════════════════════════════════════════════════════════",
+                        "# Usage: docker compose -f docker-compose.nodebench.yml up -d",
+                        "",
+                        "services:",
+                        "  flicker_detection:",
+                        "    build: ./python-mcp-servers/flicker_detection",
+                        "    ports:",
+                        '      - "8006:8006"',
+                        "    volumes:",
+                        "      - ./tmp/flicker:/app/tmp",
+                        "    restart: unless-stopped",
+                        "    healthcheck:",
+                        "      test: curl -f http://localhost:8006/health || exit 1",
+                        "      interval: 30s",
+                        "      timeout: 5s",
+                        "      retries: 3",
+                        "",
+                        "  figma_flow:",
+                        "    build: ./python-mcp-servers/figma_flow",
+                        "    ports:",
+                        '      - "8007:8007"',
+                        "    environment:",
+                        "      - FIGMA_ACCESS_TOKEN=${FIGMA_ACCESS_TOKEN:-}",
+                        "    volumes:",
+                        "      - ./tmp/figma:/app/tmp",
+                        "    restart: unless-stopped",
+                        "    healthcheck:",
+                        "      test: curl -f http://localhost:8007/health || exit 1",
+                        "      interval: 30s",
+                        "      timeout: 5s",
+                        "      retries: 3",
+                        "",
+                    ].join("\n");
+                    // Full MCP config with ALL env vars
+                    const allEnvVars = {
+                        GEMINI_API_KEY: process.env.GEMINI_API_KEY || "your-gemini-api-key",
+                        OPENAI_API_KEY: process.env.OPENAI_API_KEY || "your-openai-api-key",
+                        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY || "your-anthropic-api-key",
+                        PERPLEXITY_API_KEY: process.env.PERPLEXITY_API_KEY || "your-perplexity-api-key",
+                        GITHUB_TOKEN: process.env.GITHUB_TOKEN || "ghp_your-github-token",
+                        EMAIL_USER: process.env.EMAIL_USER || "your.email@gmail.com",
+                        EMAIL_PASS: process.env.EMAIL_PASS || "your-16-char-app-password",
+                        EMAIL_SMTP_HOST: process.env.EMAIL_SMTP_HOST || "smtp.gmail.com",
+                        EMAIL_SMTP_PORT: process.env.EMAIL_SMTP_PORT || "465",
+                        EMAIL_IMAP_HOST: process.env.EMAIL_IMAP_HOST || "imap.gmail.com",
+                        EMAIL_IMAP_PORT: process.env.EMAIL_IMAP_PORT || "993",
+                        FIGMA_ACCESS_TOKEN: process.env.FIGMA_ACCESS_TOKEN || "your-figma-token",
+                        HF_TOKEN: process.env.HF_TOKEN || "hf_your-huggingface-token",
+                    };
+                    const fullMcpConfig = JSON.stringify({
+                        mcpServers: {
+                            nodebench: {
+                                command: "npx",
+                                args: ["-y", "nodebench-mcp", "--preset", "full"],
+                                env: allEnvVars,
+                            },
+                        },
+                    }, null, 2);
+                    setupFiles = {
+                        env: {
+                            filename: ".env.nodebench",
+                            content: envTemplate,
+                            description: "Environment variable template — copy to .env and fill in your API keys",
+                        },
+                        bash: {
+                            filename: "setup-nodebench.sh",
+                            content: bashScript,
+                            description: "Bash install script — chmod +x setup-nodebench.sh && ./setup-nodebench.sh",
+                        },
+                        powershell: {
+                            filename: "setup-nodebench.ps1",
+                            content: psScript,
+                            description: "PowerShell install script — .\\setup-nodebench.ps1",
+                        },
+                        docker: {
+                            filename: "docker-compose.nodebench.yml",
+                            content: dockerCompose,
+                            description: "Docker Compose for Python servers (flicker detection + figma flow)",
+                        },
+                        mcpConfig: {
+                            filename: "mcp-config.nodebench.json",
+                            content: fullMcpConfig,
+                            description: "Full MCP config with ALL env vars — paste into Claude Code / Cursor settings",
+                        },
+                    };
+                }
+                return {
+                    summary: {
+                        totalDomains: reports.length,
+                        ready: readyCount,
+                        partial: partialCount,
+                        notConfigured: missingCount,
+                        overallStatus: missingCount === 0
+                            ? "fully_configured"
+                            : readyCount > 0
+                                ? "partially_configured"
+                                : "needs_setup",
+                    },
+                    domains: reports,
+                    ...(configSnippet ? { mcpConfigSnippet: configSnippet } : {}),
+                    ...(setupFiles ? { setupFiles } : {}),
+                    nextSteps: readyCount === reports.length
+                        ? [
+                            "All checked domains are configured! Start working.",
+                            "Run discover_tools to find the right tools for your task.",
+                            "Run getMethodology('overview') to see available methodologies.",
+                        ]
+                        : generateSetup
+                            ? [
+                                "Setup files generated! Write them to your project root:",
+                                "  1. Write .env.nodebench → fill in API keys → rename to .env",
+                                "  2. Run setup-nodebench.sh (bash) or setup-nodebench.ps1 (PowerShell) to install all deps",
+                                "  3. Optionally run docker-compose.nodebench.yml for Python servers",
+                                "  4. Copy mcp-config.nodebench.json content into your Claude Code / Cursor MCP settings",
+                                "  5. Re-run check_mcp_setup to verify everything is configured",
+                            ]
+                            : [
+                                `${missingCount} domain(s) need configuration. See setupInstructions per domain.`,
+                                "Add env vars to your MCP config (see mcpConfigSnippet) or shell profile.",
+                                "Re-run check_mcp_setup to verify after configuration.",
+                                "Tip: Most capabilities work without ALL domains configured. Start with what you need.",
+                                "Tip: Run check_mcp_setup with generate_setup=true to get ready-to-write setup files.",
+                            ],
+                };
+            },
+        },
     ];
 }
 //# sourceMappingURL=metaTools.js.map