megasearch-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ProDevs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# MegaSearch MCP
+
+[![npm version](https://badge.fury.io/js/megasearch-mcp.svg)](https://www.npmjs.com/package/megasearch-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A local MCP (Model Context Protocol) server that connects Claude Desktop to [MegaSearch](https://megasearch.prodevs.in) API using OAuth 2.0 client credentials.
+
+## Features
+
+- **No timeout issues** - Direct stdio communication avoids HTTP/SSE transport timeouts
+- **5-minute timeout** - Configurable timeout for comprehensive searches
+- **OAuth 2.0** - Secure authentication with automatic token refresh
+- **Simple setup** - Just set environment variables
+
+## What is MegaSearch?
+
+MegaSearch is an AI-powered metasearch engine that:
+- Fires 10+ search engines in parallel
+- Extracts and analyzes content from top results
+- Synthesizes comprehensive answers with citations
+- Iteratively refines queries until the answer is complete
+
+## Installation
+
+```bash
+npm install -g megasearch-mcp
+```
+
+Or use directly with npx (no installation needed):
+
+```bash
+npx megasearch-mcp
+```
+
+## Quick Start
+
+### 1. Create OAuth Client
+
+1. Go to [MegaSearch Dashboard](https://megasearch.prodevs.in/user/tokens)
+2. Sign up / Log in with Google
+3. Click **"+ Create OAuth Client"**
+4. Copy the **Client ID** and **Client Secret** (shown only once!)
+
+### 2. Configure Claude Desktop
+
+Add to your Claude Desktop config:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "megasearch": {
+      "command": "npx",
+      "args": ["megasearch-mcp"],
+      "env": {
+        "MEGASEARCH_CLIENT_ID": "mcp_your_client_id",
+        "MEGASEARCH_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Claude Desktop
+
+After saving the config, restart Claude Desktop to load the MCP server.
+
+## Usage
+
+Once configured, ask Claude to search for anything:
+
+> "Search for the latest developments in quantum computing"
+
+> "What are the best practices for React performance optimization?"
+
+> "Find recent news about AI regulations in the EU"
+
+Claude will use MegaSearch to:
+1. Fire multiple search engines in parallel
+2. Extract content from top results
+3. Analyze and synthesize a comprehensive answer
+4. Return sources with citations
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `MEGASEARCH_CLIENT_ID` | Yes | - | OAuth Client ID (starts with `mcp_`) |
+| `MEGASEARCH_CLIENT_SECRET` | Yes | - | OAuth Client Secret |
+| `MEGASEARCH_BASE_URL` | No | `https://megasearch.prodevs.in` | MegaSearch API URL |
+| `MEGASEARCH_TIMEOUT` | No | `300000` | Request timeout in ms (default: 5 min) |
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/ProDevs-Kol/megasearch-mcp.git
+cd megasearch-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+MEGASEARCH_CLIENT_ID=xxx MEGASEARCH_CLIENT_SECRET=yyy npm start
+```
+
+## Troubleshooting
+
+### "Missing MEGASEARCH_CLIENT_ID or MEGASEARCH_CLIENT_SECRET"
+
+Make sure you've set both environment variables in your Claude Desktop config.
+
+### "Failed to obtain access token"
+
+- Check that your Client ID and Secret are correct
+- Ensure your MegaSearch account is active
+- Try creating a new OAuth client
+
+### Search takes too long
+
+MegaSearch performs comprehensive searches that may take 30-60 seconds. This is expected behavior. You can reduce the timeout with `MEGASEARCH_TIMEOUT` if needed.
+
+## Related Projects
+
+- [MegaSearch](https://megasearch.prodevs.in) - The AI-powered metasearch engine
+- [n8n-nodes-megasearch](https://www.npmjs.com/package/n8n-nodes-megasearch) - n8n integration
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * MegaSearch MCP Stdio Proxy
+ *
+ * A local MCP server that connects Claude Desktop to MegaSearch API
+ * using OAuth 2.0 client credentials for authentication.
+ *
+ * Usage:
+ *   MEGASEARCH_CLIENT_ID=xxx MEGASEARCH_CLIENT_SECRET=yyy megasearch-mcp
+ *
+ * Or in Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "megasearch": {
+ *         "command": "npx",
+ *         "args": ["megasearch-mcp-proxy-stdio"],
+ *         "env": {
+ *           "MEGASEARCH_CLIENT_ID": "mcp_xxx",
+ *           "MEGASEARCH_CLIENT_SECRET": "your_secret",
+ *           "MEGASEARCH_BASE_URL": "https://megasearch.prodevs.in"
+ *         }
+ *       }
+ *     }
+ *   }
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/index.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+/**
+ * MegaSearch MCP Stdio Proxy
+ *
+ * A local MCP server that connects Claude Desktop to MegaSearch API
+ * using OAuth 2.0 client credentials for authentication.
+ *
+ * Usage:
+ *   MEGASEARCH_CLIENT_ID=xxx MEGASEARCH_CLIENT_SECRET=yyy megasearch-mcp
+ *
+ * Or in Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "megasearch": {
+ *         "command": "npx",
+ *         "args": ["megasearch-mcp-proxy-stdio"],
+ *         "env": {
+ *           "MEGASEARCH_CLIENT_ID": "mcp_xxx",
+ *           "MEGASEARCH_CLIENT_SECRET": "your_secret",
+ *           "MEGASEARCH_BASE_URL": "https://megasearch.prodevs.in"
+ *         }
+ *       }
+ *     }
+ *   }
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// Configuration from environment
+const config = {
+    baseUrl: process.env.MEGASEARCH_BASE_URL || "https://megasearch.prodevs.in",
+    clientId: process.env.MEGASEARCH_CLIENT_ID || "",
+    clientSecret: process.env.MEGASEARCH_CLIENT_SECRET || "",
+    timeout: parseInt(process.env.MEGASEARCH_TIMEOUT || "300000", 10), // 5 minutes default
+};
+let tokenCache = null;
+/**
+ * Get OAuth access token using client_credentials grant.
+ * Caches tokens and refreshes them when expired.
+ */
+async function getAccessToken() {
+    // Return cached token if still valid (with 60 second buffer)
+    if (tokenCache && Date.now() < tokenCache.expiresAt - 60000) {
+        return tokenCache.accessToken;
+    }
+    if (!config.clientId || !config.clientSecret) {
+        throw new Error("Missing MEGASEARCH_CLIENT_ID or MEGASEARCH_CLIENT_SECRET environment variables");
+    }
+    const tokenUrl = `${config.baseUrl}/api/v1/oauth/token`;
+    const response = await fetch(tokenUrl, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: new URLSearchParams({
+            grant_type: "client_credentials",
+            client_id: config.clientId,
+            client_secret: config.clientSecret,
+        }).toString(),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Failed to obtain access token: ${response.status} ${errorText}`);
+    }
+    const data = (await response.json());
+    tokenCache = {
+        accessToken: data.access_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+    };
+    return tokenCache.accessToken;
+}
+/**
+ * Execute search via MegaSearch REST API
+ */
+async function executeSearch(query) {
+    const accessToken = await getAccessToken();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+    try {
+        const response = await fetch(`${config.baseUrl}/api/v1/search`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            body: JSON.stringify({ query }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            const detail = errorData.detail ||
+                errorData.message ||
+                response.statusText;
+            if (response.status === 401) {
+                // Token might be invalid, clear cache and retry once
+                tokenCache = null;
+                throw new Error("Authentication failed. Please check your credentials.");
+            }
+            else if (response.status === 402) {
+                throw new Error("Insufficient credits. Please purchase more credits or upgrade your plan.");
+            }
+            else if (response.status === 429) {
+                throw new Error("Rate limit exceeded. Please wait a moment and try again.");
+            }
+            throw new Error(`Search failed: ${response.status} - ${detail}`);
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new Error(`Search timed out after ${config.timeout / 1000} seconds`);
+        }
+        throw error;
+    }
+}
+/**
+ * Format search response for MCP
+ */
+function formatSearchResponse(result) {
+    const lines = [];
+    // Answer section
+    lines.push(`# Answer to: ${result.query}`);
+    lines.push("");
+    lines.push(result.answer);
+    lines.push("");
+    // Sources section
+    if (result.sources && result.sources.length > 0) {
+        lines.push("---");
+        lines.push("");
+        lines.push("## Sources");
+        lines.push("");
+        for (const source of result.sources) {
+            lines.push(`[${source.index}] **${source.title}**`);
+            lines.push(`    URL: ${source.url}`);
+            if (source.provider) {
+                lines.push(`    Provider: ${source.provider}`);
+            }
+            lines.push("");
+        }
+    }
+    // Metadata section
+    if (result.metadata) {
+        lines.push("---");
+        lines.push("");
+        lines.push("## Search Metadata");
+        lines.push(`- Iterations: ${result.metadata.iterations}`);
+        lines.push(`- Providers: ${result.metadata.providers_used.join(", ")}`);
+        lines.push(`- Total time: ${result.metadata.total_time_ms}ms`);
+        lines.push(`- Used paid APIs: ${result.metadata.used_paid_apis}`);
+        if (result.metadata.gaps_identified &&
+            result.metadata.gaps_identified.length > 0) {
+            lines.push(`- Gaps identified: ${result.metadata.gaps_identified.join(", ")}`);
+        }
+        if (result.metadata.refined_queries &&
+            result.metadata.refined_queries.length > 0) {
+            lines.push(`- Query refinements: ${result.metadata.refined_queries.length}`);
+        }
+    }
+    // Usage info
+    if (result.usage) {
+        lines.push("");
+        lines.push("## Usage");
+        lines.push(`- Credits charged: ${result.usage.credits_charged}`);
+        lines.push(`- Credits remaining: ${result.usage.credits_remaining}`);
+        lines.push(`- Plan: ${result.usage.plan}`);
+    }
+    return lines.join("\n");
+}
+// Define the search tool
+const SEARCH_TOOL = {
+    name: "search",
+    description: "Search the web for any information using MegaSearch. " +
+        "Fires multiple search engines in parallel, extracts content, " +
+        "analyzes results, and synthesizes a comprehensive answer with citations. " +
+        "Just provide your question - the system handles everything else.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Your search query - ask anything",
+            },
+        },
+        required: ["query"],
+    },
+};
+// Create MCP server
+const server = new Server({
+    name: "megasearch",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle list tools request
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [SEARCH_TOOL],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (name !== "search") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Unknown tool: ${name}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const query = args?.query;
+    if (!query || typeof query !== "string" || query.trim().length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: Query is required and must be a non-empty string",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = await executeSearch(query.trim());
+        const formatted = formatSearchResponse(result);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatted,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Search error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    // Validate configuration
+    if (!config.clientId || !config.clientSecret) {
+        console.error("Error: MEGASEARCH_CLIENT_ID and MEGASEARCH_CLIENT_SECRET environment variables are required");
+        console.error("");
+        console.error("Usage:");
+        console.error("  MEGASEARCH_CLIENT_ID=mcp_xxx MEGASEARCH_CLIENT_SECRET=yyy megasearch-mcp");
+        console.error("");
+        console.error("Or set in your Claude Desktop configuration.");
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is used for MCP protocol)
+    console.error(`MegaSearch MCP Proxy started`);
+    console.error(`  Base URL: ${config.baseUrl}`);
+    console.error(`  Client ID: ${config.clientId.substring(0, 10)}...`);
+    console.error(`  Timeout: ${config.timeout / 1000}s`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "megasearch-mcp",
+  "version": "1.0.0",
+  "description": "MCP stdio proxy for MegaSearch - connects Claude Desktop to MegaSearch API using OAuth 2.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "megasearch-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "megasearch",
+    "claude",
+    "ai",
+    "search",
+    "model-context-protocol",
+    "anthropic",
+    "llm"
+  ],
+  "author": {
+    "name": "ProDevs",
+    "url": "https://prodevs.in"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ProDevs-Kol/megasearch-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ProDevs-Kol/megasearch-mcp/issues"
+  },
+  "homepage": "https://github.com/ProDevs-Kol/megasearch-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}