nodebench-mcp 1.0.0

package/dist/tools/webTools.js

@@ -0,0 +1,443 @@
+/**
+ * Web tools — URL fetching and web search capabilities.
+ * Enables agents to gather information from the web for research, ideation, and discovery.
+ *
+ * - web_search: Searches the web using AI providers with search grounding
+ * - fetch_url: Fetches a URL and extracts content as markdown/text/html
+ *
+ * Uses Gemini grounding (preferred), OpenAI web search, or Perplexity as providers.
+ * Cheerio is optional for HTML parsing.
+ */
+// ─── Dynamic import helpers ───────────────────────────────────────────────────
+async function canImport(pkg) {
+    try {
+        await import(pkg);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function getCheerio() {
+    try {
+        const mod = await import("cheerio");
+        // cheerio exports load() directly, not as default
+        return mod;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── HTML to Markdown conversion ─────────────────────────────────────────────
+function htmlToMarkdown(html, cheerio) {
+    const $ = cheerio.load(html);
+    // Remove script, style, nav, footer, header (keep main content)
+    $("script, style, nav, footer, header, aside, .ad, .advertisement, [role='navigation']").remove();
+    // Try to find main content area
+    let content = $("main, article, [role='main'], .content, .post-content, .article-content").first();
+    if (content.length === 0) {
+        content = $("body");
+    }
+    const lines = [];
+    // Extract text with structure
+    content.find("h1, h2, h3, h4, h5, h6, p, li, td, th, pre, code, blockquote").each((_, el) => {
+        const tag = el.tagName?.toLowerCase() ?? "";
+        const text = $(el).text().trim();
+        if (!text)
+            return;
+        switch (tag) {
+            case "h1":
+                lines.push(`\n# ${text}\n`);
+                break;
+            case "h2":
+                lines.push(`\n## ${text}\n`);
+                break;
+            case "h3":
+                lines.push(`\n### ${text}\n`);
+                break;
+            case "h4":
+                lines.push(`\n#### ${text}\n`);
+                break;
+            case "h5":
+            case "h6":
+                lines.push(`\n**${text}**\n`);
+                break;
+            case "p":
+                lines.push(`${text}\n`);
+                break;
+            case "li":
+                lines.push(`- ${text}`);
+                break;
+            case "pre":
+            case "code":
+                lines.push(`\`\`\`\n${text}\n\`\`\`\n`);
+                break;
+            case "blockquote":
+                lines.push(`> ${text}\n`);
+                break;
+            case "td":
+            case "th":
+                // Tables are complex, just capture cell content
+                lines.push(text);
+                break;
+        }
+    });
+    // Clean up result
+    let result = lines.join("\n");
+    // Remove excessive newlines
+    result = result.replace(/\n{3,}/g, "\n\n");
+    // Trim leading/trailing whitespace
+    result = result.trim();
+    return result;
+}
+function basicHtmlToText(html) {
+    // Fallback when cheerio not available - basic regex extraction
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[\s\S]*?<\/style>/gi, "")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+async function searchWithGemini(query, maxResults) {
+    const { GoogleGenAI } = await import("@google/genai");
+    const apiKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_AI_API_KEY || "";
+    const ai = new GoogleGenAI({ apiKey });
+    // Use Gemini with Google Search grounding
+    const response = await ai.models.generateContent({
+        model: "gemini-2.5-flash",
+        contents: [
+            {
+                role: "user",
+                parts: [
+                    {
+                        text: `Search the web for: "${query}"
+
+Return the top ${maxResults} most relevant results. For each result, provide:
+1. Title
+2. URL
+3. A 1-2 sentence snippet summarizing the content
+
+Format your response as JSON array:
+[{"title": "...", "url": "...", "snippet": "..."}]
+
+Only return the JSON array, no other text.`,
+                    },
+                ],
+            },
+        ],
+        config: {
+            tools: [{ googleSearch: {} }],
+            maxOutputTokens: 2048,
+            temperature: 0.1,
+        },
+    });
+    // Parse response
+    const text = response?.candidates?.[0]?.content?.parts?.[0]?.text ?? "[]";
+    const jsonMatch = text.match(/\[[\s\S]*\]/);
+    if (!jsonMatch)
+        return [];
+    try {
+        const results = JSON.parse(jsonMatch[0]);
+        return results.map((r) => ({
+            title: r.title || "",
+            url: r.url || "",
+            snippet: r.snippet || "",
+            source: "gemini",
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function searchWithOpenAI(query, maxResults) {
+    const OpenAI = (await import("openai")).default;
+    const client = new OpenAI();
+    // Use OpenAI with web search preview (responses API)
+    try {
+        const response = await client.responses.create({
+            model: "gpt-4o",
+            tools: [{ type: "web_search_preview" }],
+            input: `Search for: "${query}". Return the top ${maxResults} most relevant results as JSON array with title, url, snippet fields.`,
+        });
+        const text = response?.output_text ?? "[]";
+        const jsonMatch = text.match(/\[[\s\S]*\]/);
+        if (!jsonMatch)
+            return [];
+        const results = JSON.parse(jsonMatch[0]);
+        return results.map((r) => ({
+            title: r.title || "",
+            url: r.url || "",
+            snippet: r.snippet || "",
+            source: "openai",
+        }));
+    }
+    catch {
+        // Fall back to standard chat if responses API not available
+        const response = await client.chat.completions.create({
+            model: "gpt-4o",
+            messages: [
+                {
+                    role: "system",
+                    content: "You are a search assistant. Based on your knowledge, provide relevant results for the query.",
+                },
+                {
+                    role: "user",
+                    content: `Search for: "${query}". Return ${maxResults} relevant results as JSON array: [{"title": "...", "url": "...", "snippet": "..."}]`,
+                },
+            ],
+            max_tokens: 2048,
+        });
+        const text = response.choices[0]?.message?.content ?? "[]";
+        const jsonMatch = text.match(/\[[\s\S]*\]/);
+        if (!jsonMatch)
+            return [];
+        const results = JSON.parse(jsonMatch[0]);
+        return results.map((r) => ({
+            title: r.title || "",
+            url: r.url || "",
+            snippet: r.snippet || "",
+            source: "openai_knowledge",
+        }));
+    }
+}
+async function searchWithPerplexity(query, maxResults) {
+    // Perplexity uses OpenAI-compatible API
+    const OpenAI = (await import("openai")).default;
+    const client = new OpenAI({
+        apiKey: process.env.PERPLEXITY_API_KEY,
+        baseURL: "https://api.perplexity.ai",
+    });
+    const response = await client.chat.completions.create({
+        model: "llama-3.1-sonar-large-128k-online",
+        messages: [
+            {
+                role: "system",
+                content: "Be precise and concise. Return results as JSON.",
+            },
+            {
+                role: "user",
+                content: `Search for: "${query}". Return the top ${maxResults} results as JSON array: [{"title": "...", "url": "...", "snippet": "..."}]`,
+            },
+        ],
+        max_tokens: 2048,
+    });
+    const text = response.choices[0]?.message?.content ?? "[]";
+    const jsonMatch = text.match(/\[[\s\S]*\]/);
+    if (!jsonMatch)
+        return [];
+    try {
+        const results = JSON.parse(jsonMatch[0]);
+        return results.map((r) => ({
+            title: r.title || "",
+            url: r.url || "",
+            snippet: r.snippet || "",
+            source: "perplexity",
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export const webTools = [
+    {
+        name: "web_search",
+        description: "Search the web using AI providers with search grounding. Returns structured search results with titles, URLs, and snippets. Auto-selects best provider: Gemini (Google Search grounding) > OpenAI (web search preview) > Perplexity. Use for research, market analysis, tech discovery, and gathering current information.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The search query (e.g., 'TypeScript MCP servers 2026', 'AI agent frameworks comparison')",
+                },
+                maxResults: {
+                    type: "number",
+                    description: "Maximum number of results to return (default: 5, max: 20)",
+                },
+                provider: {
+                    type: "string",
+                    enum: ["auto", "gemini", "openai", "perplexity"],
+                    description: "Which search provider to use. Default: 'auto' (selects best available).",
+                },
+            },
+            required: ["query"],
+        },
+        handler: async (args) => {
+            const query = args.query;
+            const maxResults = Math.min(args.maxResults ?? 5, 20);
+            const providerChoice = args.provider ?? "auto";
+            let selectedProvider = null;
+            if (providerChoice !== "auto") {
+                selectedProvider = providerChoice;
+            }
+            else {
+                // Auto-select: Gemini > OpenAI > Perplexity
+                if ((process.env.GEMINI_API_KEY || process.env.GOOGLE_AI_API_KEY) &&
+                    (await canImport("@google/genai"))) {
+                    selectedProvider = "gemini";
+                }
+                else if (process.env.OPENAI_API_KEY && (await canImport("openai"))) {
+                    selectedProvider = "openai";
+                }
+                else if (process.env.PERPLEXITY_API_KEY && (await canImport("openai"))) {
+                    selectedProvider = "perplexity";
+                }
+            }
+            if (!selectedProvider) {
+                return {
+                    error: true,
+                    query,
+                    message: "No search provider available.",
+                    suggestion: "Set one of: GEMINI_API_KEY (recommended for Google Search grounding), OPENAI_API_KEY, or PERPLEXITY_API_KEY. Install SDK: @google/genai or openai.",
+                };
+            }
+            try {
+                let results;
+                switch (selectedProvider) {
+                    case "gemini":
+                        results = await searchWithGemini(query, maxResults);
+                        break;
+                    case "openai":
+                        results = await searchWithOpenAI(query, maxResults);
+                        break;
+                    case "perplexity":
+                        results = await searchWithPerplexity(query, maxResults);
+                        break;
+                }
+                return {
+                    query,
+                    results,
+                    provider: selectedProvider,
+                    resultCount: results.length,
+                    searchedAt: new Date().toISOString(),
+                };
+            }
+            catch (err) {
+                return {
+                    error: true,
+                    query,
+                    provider: selectedProvider,
+                    message: `Search failed: ${err.message}`,
+                    suggestion: "Check that the API key is valid. Try a different provider.",
+                };
+            }
+        },
+    },
+    {
+        name: "fetch_url",
+        description: "Fetch a URL and extract its content as markdown, text, or raw HTML. Useful for reading documentation, blog posts, API references, and web pages. Uses cheerio for HTML parsing when available, with fallback to basic text extraction.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: {
+                    type: "string",
+                    description: "The URL to fetch (e.g., 'https://docs.example.com/getting-started')",
+                },
+                extractMode: {
+                    type: "string",
+                    enum: ["markdown", "text", "html"],
+                    description: "How to extract content: 'markdown' (structured), 'text' (plain), 'html' (raw). Default: 'markdown'.",
+                },
+                maxLength: {
+                    type: "number",
+                    description: "Maximum content length to return (default: 50000 characters)",
+                },
+            },
+            required: ["url"],
+        },
+        handler: async (args) => {
+            const url = args.url;
+            const extractMode = args.extractMode ?? "markdown";
+            const maxLength = args.maxLength ?? 50000;
+            // Validate URL
+            let parsedUrl;
+            try {
+                parsedUrl = new URL(url);
+            }
+            catch {
+                return {
+                    error: true,
+                    url,
+                    message: "Invalid URL format",
+                    suggestion: "Provide a valid URL starting with http:// or https://",
+                };
+            }
+            try {
+                const response = await fetch(url, {
+                    headers: {
+                        "User-Agent": "Mozilla/5.0 (compatible; NodeBench-MCP/1.0; +https://github.com/nodebench)",
+                        Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                    },
+                    redirect: "follow",
+                });
+                if (!response.ok) {
+                    return {
+                        error: true,
+                        url,
+                        status: response.status,
+                        message: `HTTP ${response.status}: ${response.statusText}`,
+                        suggestion: "Check that the URL is accessible and not blocked.",
+                    };
+                }
+                const contentType = response.headers.get("content-type") ?? "";
+                const html = await response.text();
+                // Extract title from HTML
+                const titleMatch = html.match(/<title[^>]*>([^<]*)<\/title>/i);
+                const title = titleMatch?.[1]?.trim() ?? parsedUrl.hostname;
+                let content;
+                if (extractMode === "html") {
+                    content = html;
+                }
+                else if (extractMode === "markdown") {
+                    const cheerio = await getCheerio();
+                    if (cheerio) {
+                        content = htmlToMarkdown(html, cheerio);
+                    }
+                    else {
+                        // Fallback to text extraction
+                        content = basicHtmlToText(html);
+                    }
+                }
+                else {
+                    // text mode
+                    const cheerio = await getCheerio();
+                    if (cheerio) {
+                        const $ = cheerio.load(html);
+                        $("script, style").remove();
+                        content = $("body").text().replace(/\s+/g, " ").trim();
+                    }
+                    else {
+                        content = basicHtmlToText(html);
+                    }
+                }
+                // Truncate if needed
+                const truncated = content.length > maxLength;
+                if (truncated) {
+                    content = content.slice(0, maxLength) + "\n\n... [truncated]";
+                }
+                return {
+                    url,
+                    finalUrl: response.url, // After redirects
+                    title,
+                    contentType,
+                    extractMode,
+                    content,
+                    contentLength: content.length,
+                    truncated,
+                    fetchedAt: new Date().toISOString(),
+                    cheerioAvailable: !!(await getCheerio()),
+                };
+            }
+            catch (err) {
+                return {
+                    error: true,
+                    url,
+                    message: `Fetch failed: ${err.message}`,
+                    suggestion: "Check network connectivity and that the URL is accessible.",
+                };
+            }
+        },
+    },
+];
+//# sourceMappingURL=webTools.js.map

package/dist/tools/webTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTools.js","sourceRoot":"","sources":["../../src/tools/webTools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export type ContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+export type McpTool = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    /** If true, handler returns ContentBlock[] directly instead of a JSON-serializable object. */
+    rawContent?: boolean;
+    handler: (args: any) => Promise<unknown>;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "nodebench-mcp",
+  "version": "1.0.0",
+  "description": "NodeBench MCP server — 46 tools for AI-powered development. Web search, GitHub discovery, vision analysis, verification flywheel.",
+  "type": "module",
+  "bin": {
+    "nodebench-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "verify": "node test-setup.mjs",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai-agents",
+    "web-search",
+    "github",
+    "vision",
+    "verification",
+    "sqlite"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodebench/nodebench-ai.git",
+    "directory": "packages/mcp-local"
+  },
+  "homepage": "https://github.com/nodebench/nodebench-ai/tree/main/packages/mcp-local#readme",
+  "bugs": {
+    "url": "https://github.com/nodebench/nodebench-ai/issues"
+  },
+  "license": "MIT",
+  "author": "NodeBench",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "better-sqlite3": "^11.0.0"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.57.0",
+    "sharp": "^0.34.5",
+    "@google/genai": "^1.10.0",
+    "openai": "^5.8.2",
+    "@anthropic-ai/sdk": "^0.71.2",
+    "cheerio": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}