@oevortex/ddg_search 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.1.3] - 2025-11-30
+### Changed
+- Replaced Felo AI tool with IAsk AI tool for advanced AI-powered search
+- Added `src/utils/search_iask.js` implementing IAsk API client
+- Added `src/tools/iaskTool.js` tool definition and handler
+- Updated `src/index.ts` to use IAsk tool instead of Felo
+- Updated `package.json` description, keywords, and dependencies (`turndown`, `ws`)
+- Updated `README.md` to reference IAsk AI and document new tool parameters
+- Removed old Felo tool files (`feloTool.js`, `search_felo.js`)
+
+## [1.1.2] - 2025-11-29
+### Added
+- Initial release with DuckDuckGo and Felo AI search tools
+- MCP server implementation
+- Caching, rotating user agents, and web scraping features

package/Dockerfile

@@ -1,20 +1,26 @@
-# Use official Node.js LTS image
-FROM node:20-alpine
-
-# Set working directory
+# Build stage: install dependencies
+FROM node:22-slim AS build
 WORKDIR /app
 
-# Copy package.json and package-lock.json
-COPY package*.json ./
+# Copy package manifests and lockfile first for better caching
+COPY package.json package-lock.json ./
 
-# Install dependencies
-RUN npm install --production
+# Install production dependencies (use npm ci when lockfile exists)
+RUN if [ -f package-lock.json ]; then npm ci --production; else npm install --production; fi
 
-# Copy source code
+# Copy application source
 COPY . .
 
-# Expose port (if your app listens on a port, e.g. 3000)
+# Final minimal runtime image
+FROM node:22-slim AS runtime
+WORKDIR /app
+
+# Copy node_modules and built app from build stage
+COPY --from=build /app/node_modules ./node_modules
+COPY --from=build /app .
+
+# Expose port in case the MCP server needs it
 EXPOSE 3000
 
-# Default command (adjust if your entry point is different)
-CMD ["node", "src/index.js"]
+# Default command: use the CLI entry which starts the MCP server
+CMD ["node", "bin/cli.js"]

package/README.md

@@ -2,8 +2,8 @@
   <img src="https://img.shields.io/npm/v/@oevortex/ddg_search.svg" alt="npm version" />
   <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0" />
   <img src="https://img.shields.io/badge/YouTube-%40OEvortex-red.svg" alt="YouTube Channel" />
-  <h1>DuckDuckGo & Felo AI Search MCP 🔍🧠</h1>
-  <p>A blazing-fast, privacy-friendly Model Context Protocol (MCP) server for web search and AI-powered responses using DuckDuckGo and Felo AI.</p>
+  <h1>DuckDuckGo & IAsk AI Search MCP 🔍🧠</h1>
+  <p>A blazing-fast, privacy-friendly Model Context Protocol (MCP) server for web search and AI-powered responses using DuckDuckGo and IAsk AI.</p>
   <a href="https://glama.ai/mcp/servers/@OEvortex/ddg_search">
     <img width="380" height="200" src="https://glama.ai/mcp/servers/@OEvortex/ddg_search/badge" alt="DuckDuckGo Search MCP server" />
   </a>
@@ -20,9 +20,7 @@
 ## ✨ Features
 
 <div style="display: flex; flex-wrap: wrap; gap: 1.5em; margin-bottom: 1.5em;">  <div><b>🌐 Web search</b> using DuckDuckGo HTML</div>
-  <div><b>🧠 AI search</b> using Felo AI</div>
-  <div><b>📄 URL content extraction</b> with smart filtering</div>
-  <div><b>📊 URL metadata extraction</b> (title, description, images)</div>
+  <div><b>🧠 AI search</b> using IAsk AI</div>
   <div><b>⚡ Performance optimized</b> with caching</div>
   <div><b>🛡️ Security features</b> including rate limiting and rotating user agents</div>
   <div><b>🔌 MCP-compliant</b> server implementation</div>
@@ -52,7 +50,7 @@ npx -y @oevortex/ddg_search@latest
 ## 🛠️ Installation Options
 
 <details>
-<summary><b>Global Installation</b></summary>
+<summary><b>Global Installation (npm)</b></summary>
 
 ```bash
 npm install -g @oevortex/ddg_search
@@ -66,6 +64,36 @@ ddg-search-mcp
 
 </details>
 
+<details>
+<summary><b>Global Installation (Yarn)</b></summary>
+
+```bash
+yarn global add @oevortex/ddg_search
+```
+
+Run globally:
+
+```bash
+ddg-search-mcp
+```
+
+</details>
+
+<details>
+<summary><b>Global Installation (pnpm)</b></summary>
+
+```bash
+pnpm add -g @oevortex/ddg_search
+```
+
+Run globally:
+
+```bash
+ddg-search-mcp
+```
+
+</details>
+
 <details>
 <summary><b>Local Installation (Development)</b></summary>
 
@@ -76,6 +104,20 @@ npm install
 npm start
 ```
 
+Or with Yarn:
+
+```bash
+yarn install
+yarn start
+```
+
+Or with pnpm:
+
+```bash
+pnpm install
+pnpm start
+```
+
 </details>
 
 ---
@@ -140,34 +182,15 @@ Or if installed globally:
     <i>Example: Search the web for "climate change solutions"</i>
   </div>
   <div style="margin-bottom: 1.5em;">
-    <b>🧠 Felo AI Search Tool</b><br/>
-    <code>felo-search</code><br/>
+    <b>🧠 IAsk AI Search Tool</b><br/>
+    <code>iask-search</code><br/>
     <ul>
-      <li><b>query</b> (string, required): The search query or prompt</li>
+      <li><b>query</b> (string, required): The search query or question</li>
+      <li><b>mode</b> (string, optional, default: "question"): Search mode - "question", "academic", "forums", "wiki", or "thinking"</li>
+      <li><b>detailLevel</b> (string, optional): Response detail level - "concise", "detailed", or "comprehensive"</li>
       <li><b>stream</b> (boolean, optional, default: false): Whether to stream the response</li>
     </ul>
-    <i>Example: Search Felo AI for "Explain quantum computing in simple terms"</i>
-  </div>
-  <div style="margin-bottom: 1.5em;">
-    <b>📄 Fetch URL Tool</b><br/>
-    <code>fetch-url</code><br/>
-    <ul>
-      <li><b>url</b> (string, required): The URL to fetch</li>
-      <li><b>maxLength</b> (integer, optional, default: 10000): Max content length</li>
-      <li><b>extractMainContent</b> (boolean, optional, default: true): Extract main content</li>
-      <li><b>includeLinks</b> (boolean, optional, default: true): Include link text</li>
-      <li><b>includeImages</b> (boolean, optional, default: true): Include image alt text</li>
-      <li><b>excludeTags</b> (array, optional): Tags to exclude</li>
-    </ul>
-    <i>Example: Fetch the content from "https://example.com"</i>
-  </div>
-  <div style="margin-bottom: 1.5em;">
-    <b>📊 URL Metadata Tool</b><br/>
-    <code>url-metadata</code><br/>
-    <ul>
-      <li><b>url</b> (string, required): The URL to extract metadata from</li>
-    </ul>
-    <i>Example: Get metadata for "https://example.com"</i>
+    <i>Example: Search IAsk AI for "Explain quantum computing in simple terms"</i>
   </div>
 </div>
 
@@ -182,12 +205,10 @@ src/
   index.js        # Main entry point
   tools/          # Tool definitions and handlers
     searchTool.js
-    fetchUrlTool.js
-    metadataTool.js
-    feloTool.js
+    iaskTool.js
   utils/
     search.js     # Search and URL utilities
-    search_felo.js # Felo AI search utilities
+    search_iask.js # IAsk AI search utilities
 package.json
 README.md
 ```
@@ -227,4 +248,4 @@ Apache License 2.0
 
 <div align="center">
   <sub>Made with ❤️ by <a href="https://youtube.com/@OEvortex">@OEvortex</a></sub>
-</div>
+</div>

package/bin/cli.js

@@ -12,48 +12,58 @@ async function startServer() {
   try {
     // Dynamically import the modules
     const { searchToolDefinition, searchToolHandler } = await import(`${modulePath}/tools/searchTool.js`);
-    const { fetchUrlToolDefinition, fetchUrlToolHandler } = await import(`${modulePath}/tools/fetchUrlTool.js`);
-    const { metadataToolDefinition, metadataToolHandler } = await import(`${modulePath}/tools/metadataTool.js`);
-    const { feloToolDefinition, feloToolHandler } = await import(`${modulePath}/tools/feloTool.js`);    // Create the MCP server
+    const { feloToolDefinition, feloToolHandler } = await import(`${modulePath}/tools/feloTool.js`);
+
+    // Create the MCP server
     const server = new Server({
       id: 'ddg-search-mcp',
       name: 'DuckDuckGo & Felo AI Search MCP',
       description: 'A Model Context Protocol server for web search using DuckDuckGo and Felo AI',
-      version: '1.1.1'
+      version: '1.1.2'
     }, {
       capabilities: {
-        tools: {}
+        tools: {
+          listChanged: true
+        }
       }
     });
 
+    // Global variable to track available tools
+    let availableTools = [
+      searchToolDefinition,
+      feloToolDefinition
+    ];
+
     // Define available tools
     server.setRequestHandler(ListToolsRequestSchema, async () => {
       return {
-        tools: [
-          searchToolDefinition,
-          fetchUrlToolDefinition,
-          metadataToolDefinition,
-          feloToolDefinition
-        ]
+        tools: availableTools
       };
     });
 
+    // Function to notify clients when tools list changes
+    function notifyToolsChanged() {
+      server.notification({
+        method: 'notifications/tools/list_changed'
+      });
+    }
+
     // Handle tool execution
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
       try {
         const { name, arguments: args } = request.params;
+        
+        // Validate tool name
+        const validTools = ['web-search', 'felo-search'];
+        if (!validTools.includes(name)) {
+          throw new Error(`Unknown tool: ${name}`);
+        }
 
         // Route to the appropriate tool handler
         switch (name) {
           case 'web-search':
             return await searchToolHandler(args);
 
-          case 'fetch-url':
-            return await fetchUrlToolHandler(args);
-
-          case 'url-metadata':
-            return await metadataToolHandler(args);
-          
           case 'felo-search':
             return await feloToolHandler(args);
 
@@ -61,13 +71,15 @@ async function startServer() {
             throw new Error(`Tool not found: ${name}`);
         }
       } catch (error) {
-        console.error(`Error handling ${request.params.name} request:`, error);
+        console.error(`Error handling ${request.params.name} tool call:`, error);
+        
+        // Return proper tool execution error format
         return {
           isError: true,
           content: [
             {
               type: 'text',
-              text: `Error: ${error.message}`
+              text: `Error executing tool '${request.params.name}': ${error.message}`
             }
           ]
         };
@@ -109,8 +121,6 @@ Options:
 
 This MCP server provides the following tools:
   - web-search: Search the web using DuckDuckGo
-  - fetch-url: Fetch and extract content from a URL
-  - url-metadata: Extract metadata from a URL
   - felo-search: Search using Felo AI for AI-generated responses
 
 Created by @OEvortex

package/package.json

@@ -1 +1 @@
-{"name":"@oevortex/ddg_search","version":"1.1.2","description":"A Model Context Protocol server for web search using DuckDuckGo and Felo AI","main":"src/index.js","bin":{"ddg-search-mcp":"bin/cli.js","oevortex-ddg-search":"bin/cli.js"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node bin/cli.js","prepublishOnly":"npm run lint","lint":"echo \"No linting configured\""},"publishConfig":{"access":"public"},"keywords":["mcp","model-context-protocol","duckduckgo","felo","search","web-search","ai-search","claude","ai","llm"],"author":"OEvortex","license":"Apache-2.0","type":"module","dependencies":{"@modelcontextprotocol/sdk":"^1.9.0","axios":"^1.8.4","cheerio":"^1.0.0","jsdom":"^26.1.0","uuid":"^9.0.1"}}
+{"name":"@oevortex/ddg_search","version":"1.1.4","description":"A Model Context Protocol server for web search using DuckDuckGo and IAsk AI","main":"src/index.js","module":"src/index.ts","exports":{".":{"import":"./src/index.js","default":"./src/index.js"}},"bin":{"ddg-search-mcp":"bin/cli.js","oevortex-ddg-search":"bin/cli.js"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node bin/cli.js","prepublishOnly":"npm run lint","lint":"echo \"No linting configured\"","build":"npx @smithery/cli build","dev":"npx @smithery/cli dev"},"publishConfig":{"access":"public"},"keywords":["mcp","model-context-protocol","duckduckgo","iask","search","web-search","ai-search","claude","ai","llm"],"author":"OEvortex","license":"Apache-2.0","type":"module","dependencies":{"@modelcontextprotocol/sdk":"^1.17.4","axios":"^1.8.4","cheerio":"^1.0.0","jsdom":"^26.1.0","smithery":"^0.5.2","turndown":"^7.2.2","uuid":"^9.0.1","ws":"^8.18.3"},"devDependencies":{"@types/node":"^24.3.0","tsx":"^4.20.4","typescript":"^5.9.2"}}

package/smithery.yaml

@@ -0,0 +1,12 @@
+runtime: typescript
+
+build:
+  external:
+    - canvas
+    - utf-8-validate
+    - bufferutil
+  esbuild:
+    bundle: true
+    platform: node
+    format: cjs
+    target: node18

package/src/index.js

@@ -1,82 +1,95 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 
 // Import tool definitions and handlers
 import { searchToolDefinition, searchToolHandler } from './tools/searchTool.js';
-import { fetchUrlToolDefinition, fetchUrlToolHandler } from './tools/fetchUrlTool.js';
-import { metadataToolDefinition, metadataToolHandler } from './tools/metadataTool.js';
 import { feloToolDefinition, feloToolHandler } from './tools/feloTool.js';
 
-// Create the MCP server
-const server = new Server({
-  id: 'ddg-search-mcp',
-  name: 'DuckDuckGo & Felo AI Search MCP',
-  description: 'A Model Context Protocol server for web search using DuckDuckGo and Felo AI',
-  version: '1.1.1'
-}, {
-  capabilities: {
-    tools: {}
-  }
-});
+// Required: Export default createServer function for Smithery
+export default function createServer({ config } = {}) {
+  console.log('Creating MCP server with latest SDK...');
 
-// Define available tools
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      searchToolDefinition,
-      fetchUrlToolDefinition,
-      metadataToolDefinition,
-      feloToolDefinition
-    ]
-  };
-});
+  // Global variable to track available tools
+  const availableTools = [
+    searchToolDefinition,
+    feloToolDefinition
+  ];
+  
+  console.log('Available tools:', availableTools.map(t => t.name));
 
-// Handle tool execution
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  try {
-    const { name, arguments: args } = request.params;
-      // Route to the appropriate tool handler
-    switch (name) {
-      case 'web-search':
-        return await searchToolHandler(args);
-      
-      case 'fetch-url':
-        return await fetchUrlToolHandler(args);
-      
-      case 'url-metadata':
-        return await metadataToolHandler(args);
-      
-      case 'felo-search':
-        return await feloToolHandler(args);
-      
-      default:
-        throw new Error(`Tool not found: ${name}`);
+  // Create the MCP server using the Server class
+  const server = new Server({
+    name: 'ddg-search-mcp',
+    version: '1.1.2'
+  }, {
+    capabilities: {
+      tools: {
+        listChanged: true
+      }
     }
-  } catch (error) {
-    console.error(`Error handling ${request.params.name} request:`, error);
+  });
+
+  // Define available tools
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    console.log('Tools list requested, returning:', availableTools.length, 'tools');
     return {
-      isError: true,
-      content: [
-        {
-          type: 'text',
-          text: `Error: ${error.message}`
-        }
-      ]
+      tools: availableTools
     };
-  }
-});
+  });
 
-// Start the server with stdio transport
-async function main() {
-  try {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('WebSearch MCP server started and listening on stdio');
-  } catch (error) {
-    console.error('Failed to start server:', error);
-    process.exit(1);
-  }
+  // Handle tool execution
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+      const { name, arguments: args } = request.params;
+      console.log(`Tool call received: ${name} with args:`, args);
+      
+      // Route to the appropriate tool handler
+      switch (name) {
+        case 'web-search':
+          return await searchToolHandler(args);
+
+        case 'felo-search':
+          return await feloToolHandler(args);
+
+        default:
+          throw new Error(`Tool not found: ${name}`);
+      }
+    } catch (error) {
+      console.error(`Error handling ${request.params.name} tool call:`, error);
+      
+      // Return proper tool execution error format
+      return {
+        isError: true,
+        content: [
+          {
+            type: 'text',
+            text: `Error executing tool '${request.params.name}': ${error.message}`
+          }
+        ]
+      };
+    }
+  });
+
+  console.log('MCP server created successfully');
+  
+  // Return the server instance (required for Smithery)
+  return server;
 }
 
-main();
+// Legacy standalone server support (for CLI usage)
+if (import.meta.url === `file://${process.argv[1]}`) {
+  async function main() {
+    try {
+      const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+      const server = createServer();
+      const transport = new StdioServerTransport();
+      await server.connect(transport);
+      console.error('WebSearch MCP server started and listening on stdio');
+    } catch (error) {
+      console.error('Failed to start server:', error);
+      process.exit(1);
+    }
+  }
+
+  main();
+}

package/src/index.ts

@@ -0,0 +1,80 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+// Import tool definitions and handlers
+import { searchToolDefinition, searchToolHandler } from './tools/searchTool.js';
+import { iaskToolDefinition, iaskToolHandler } from './tools/iaskTool.js';
+
+// Required: Export default createServer function for Smithery
+export default function createServer({ config }: { config?: any } = {}) {
+  console.log('Creating MCP server with latest SDK...');
+
+  // Global variable to track available tools
+  const availableTools = [
+    searchToolDefinition,
+    iaskToolDefinition
+  ];
+  
+  console.log('Available tools:', availableTools.map(t => t.name));
+
+  // Create the MCP server using the Server class
+  const server = new Server({
+    name: 'ddg-search-mcp',
+    version: '1.1.2'
+  }, {
+    capabilities: {
+      tools: {
+        listChanged: true
+      }
+    }
+  });
+
+  // Define available tools
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    console.log('Tools list requested, returning:', availableTools.length, 'tools');
+    return {
+      tools: availableTools
+    };
+  });
+
+  // Handle tool execution
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+      const { name, arguments: args } = request.params;
+      console.log(`Tool call received: ${name} with args:`, args);
+      
+      // Route to the appropriate tool handler
+      switch (name) {
+        case 'web-search':
+          return await searchToolHandler(args);
+
+        case 'iask-search':
+          return await iaskToolHandler(args);
+
+        default:
+          throw new Error(`Tool not found: ${name}`);
+      }
+    } catch (error: any) {
+      console.error(`Error handling ${request.params.name} tool call:`, error);
+      
+      // Return proper tool execution error format
+      return {
+        isError: true,
+        content: [
+          {
+            type: 'text',
+            text: `Error executing tool '${request.params.name}': ${error.message}`
+          }
+        ]
+      };
+    }
+  });
+
+  console.log('MCP server created successfully');
+  
+  // Return the server instance (required for Smithery)
+  return server;
+}
+
+// Optional: No configuration schema needed for this server
+// export const configSchema = z.object({});

package/src/tools/iaskTool.js

@@ -0,0 +1,101 @@
+import { searchIAsk, VALID_MODES, VALID_DETAIL_LEVELS } from '../utils/search_iask.js';
+
+/**
+ * IAsk AI search tool definition
+ */
+export const iaskToolDefinition = {
+  name: 'iask-search',
+  title: 'IAsk AI Search',
+  description: 'AI-powered search using IAsk.ai. Retrieves comprehensive, AI-generated responses based on web content. Supports different search modes (question, academic, forums, wiki, thinking) and detail levels (concise, detailed, comprehensive). Ideal for getting well-researched answers to complex questions.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: {
+        type: 'string',
+        description: 'The search query or question to ask. Supports natural language questions for comprehensive AI-generated responses.'
+      },
+      mode: {
+        type: 'string',
+        description: 'Search mode to use. Options: "question" (general questions), "academic" (scholarly/research), "forums" (community discussions), "wiki" (encyclopedia-style), "thinking" (deep analysis). Default is "question".',
+        enum: VALID_MODES,
+        default: 'question'
+      },
+      detailLevel: {
+        type: 'string',
+        description: 'Level of detail in the response. Options: "concise" (brief), "detailed" (moderate), "comprehensive" (extensive). Default is null (standard response).',
+        enum: VALID_DETAIL_LEVELS
+      },
+      stream: {
+        type: 'boolean',
+        description: 'Enable streaming mode to receive incremental results. Default is false.',
+        default: false
+      }
+    },
+    required: ['query']
+  },
+  annotations: {
+    readOnlyHint: true,
+    openWorldHint: false
+  }
+};
+
+/**
+ * IAsk AI search tool handler
+ * @param {Object} params - The tool parameters
+ * @returns {Promise<Object>} - The tool result
+ */
+export async function iaskToolHandler(params) {
+  const { 
+    query, 
+    mode = 'question', 
+    detailLevel = null, 
+    stream = false 
+  } = params;
+  
+  console.log(`Searching IAsk AI for: "${query}" (mode: ${mode}, detailLevel: ${detailLevel || 'default'}, stream: ${stream})`);
+  
+  try {
+    if (stream) {
+      // For streaming responses, collect them and return
+      let fullResponse = '';
+      const chunks = [];
+      
+      for await (const chunk of await searchIAsk(query, true, false, mode, detailLevel)) {
+        chunks.push(chunk);
+        fullResponse += chunk;
+      }
+      
+      return {
+        content: [
+          {
+            type: 'text',
+            text: fullResponse || 'No results found.'
+          }
+        ]
+      };
+    } else {
+      // For non-streaming responses
+      const response = await searchIAsk(query, false, false, mode, detailLevel);
+      
+      return {
+        content: [
+          {
+            type: 'text',
+            text: response || 'No results found.'
+          }
+        ]
+      };
+    }
+  } catch (error) {
+    console.error(`Error in IAsk search: ${error.message}`);
+    return {
+      isError: true,
+      content: [
+        {
+          type: 'text',
+          text: `Error searching IAsk: ${error.message}`
+        }
+      ]
+    };
+  }
+}