@oevortex/ddg_search 1.1.9 → 1.2.1

package/CHANGELOG.md

@@ -1,13 +1,39 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-## [1.1.9] - 2025-12-21
-### Fixed
-- Fixed JSON parsing error in searchTool handler that caused "invalid character 'S' looking for beginning of value" 
-- Removed JSON.stringify approach and implemented formatted text output for web search results
-- Improved result formatting to display numbered items, titles, URLs, snippets, and content consistently
-
-## [1.1.8] - 2025-12-03
+# Changelog
+
+All notable changes to this project will be documented in this file.
+## [1.2.1] - 2026-01-19
+### Added
+- Brave AI Search provider and tool with research mode toggle
+- Brave AI search utility with streaming response parsing
+- Brave AI tool tests and MCP integration coverage
+- Updated CLI help text and README documentation for Brave AI
+
+### Changed
+- Server and CLI tool registry to include brave-search
+
+## [1.2.0] - 2025-12-21
+### Added
+- Comprehensive Jest testing framework with ES module support
+- Complete unit test suite for all utility functions (search, user_agents, search_iask, search_monica)
+- Integration tests for MCP server functionality and tool routing
+- Test infrastructure with mocking for all external dependencies
+- Input validation across all search modules and tools
+- Enhanced error handling with specific network error types
+- Performance optimizations with timeout management and caching
+- Improved logging and monitoring capabilities
+- Fixed JSON parsing error in searchTool handler (1.1.9 regression)
+- Updated package.json with comprehensive test scripts
+- Added Babel configuration for test compatibility
+
+### Improved
+- Search module robustness with AbortController and timeout management
+- IAsk AI WebSocket connection handling with enhanced error reporting
+- Monica AI stream processing with improved validation
+- Tool schema validation with comprehensive parameter checking
+- User agent rotation consistency and logging
+- Cache management with hit detection and size controls
+
+## [1.1.9] - 2025-12-21
 ### Added
 - Added new `getRandomUserAgent` function to rotate user agents
 - Added new `src/utils/user_agents.js` file containing list of user agents

package/README.md

@@ -8,10 +8,10 @@
   <a href="https://youtube.com/@OEvortex">
     <img src="https://img.shields.io/badge/YouTube-%40OEvortex-red.svg" alt="YouTube Channel" />
   </a>
-  <h1>DuckDuckGo, IAsk AI & Monica Search MCP <span style="font-size:2.2rem;">🔍🧠</span></h1>
+  <h1>DuckDuckGo, IAsk AI, Monica & Brave AI Search MCP <span style="font-size:2.2rem;">🔍🧠</span></h1>
   <p style="font-size:1.15rem; max-width:600px; margin:0 auto;">
     <strong>Lightning-fast, privacy-first Model Context Protocol (MCP) server for web search and AI-powered answers.<br>
-    Powered by DuckDuckGo, IAsk AI and Monica.</strong>
+    Powered by DuckDuckGo, IAsk AI, Monica, and Brave AI.</strong>
   </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" />
@@ -30,7 +30,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 IAsk AI & Monica</div>
+  <div><b>🧠 AI search</b> using IAsk AI, Monica & Brave 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>
@@ -211,6 +211,15 @@ Or if installed globally:
     </ul>
     <i>Example: Search Monica AI for "Latest advancements in AI"</i>
   </div>
+  <div style="margin-bottom: 1.5em;">
+    <b>🛡️ Brave AI Search Tool</b><br/>
+    <code>brave-search</code><br/>
+    <ul>
+      <li><b>query</b> (string, required): The search query or question</li>
+      <li><b>enableResearch</b> (boolean, optional, default: false): Enable deep research mode</li>
+    </ul>
+    <i>Example: Search Brave AI for "Summarize the latest AI safety research"</i>
+  </div>
 </div>
 
 ---
@@ -226,11 +235,13 @@ src/
     searchTool.js
     iaskTool.js
     monicaTool.js
+    braveTool.js
   utils/
     search.js     # Search and URL utilities
     user_agents.js
     search_monica.js
     search_iask.js # IAsk AI search utilities
+    search_brave_ai.js
 package.json
 README.md
 ```

package/babel.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  presets: [
+    [
+      '@babel/preset-env',
+      {
+        targets: {
+          node: 'current'
+        }
+      }
+    ]
+  ]
+};

package/bin/cli.js

@@ -14,12 +14,13 @@ async function startServer() {
     const { searchToolDefinition, searchToolHandler } = await import(`${modulePath}/tools/searchTool.js`);
     const { iaskToolDefinition, iaskToolHandler } = await import(`${modulePath}/tools/iaskTool.js`);
     const { monicaToolDefinition, monicaToolHandler } = await import(`${modulePath}/tools/monicaTool.js`);
+    const { braveToolDefinition, braveToolHandler } = await import(`${modulePath}/tools/braveTool.js`);
 
     // Create the MCP server
     const server = new Server({
       id: 'ddg-search-mcp',
-      name: 'DuckDuckGo, IAsk AI & Monica Search MCP',
-      description: 'A Model Context Protocol server for web search using DuckDuckGo, IAsk AI and Monica',
+      name: 'DuckDuckGo, IAsk AI, Monica & Brave AI Search MCP',
+      description: 'A Model Context Protocol server for web search using DuckDuckGo, IAsk AI, Monica, and Brave AI',
       version: '1.1.8'
     }, {
       capabilities: {
@@ -33,7 +34,8 @@ async function startServer() {
     let availableTools = [
       searchToolDefinition,
       iaskToolDefinition,
-      monicaToolDefinition
+      monicaToolDefinition,
+      braveToolDefinition
     ];
 
     // Define available tools
@@ -56,7 +58,7 @@ async function startServer() {
         const { name, arguments: args } = request.params;
         
         // Validate tool name
-        const validTools = ['web-search', 'iask-search', 'monica-search'];
+        const validTools = ['web-search', 'iask-search', 'monica-search', 'brave-search'];
         if (!validTools.includes(name)) {
           throw new Error(`Unknown tool: ${name}`);
         }
@@ -72,6 +74,9 @@ async function startServer() {
           case 'monica-search':
             return await monicaToolHandler(args);
 
+          case 'brave-search':
+            return await braveToolHandler(args);
+
           default:
             throw new Error(`Tool not found: ${name}`);
         }
@@ -92,7 +97,7 @@ async function startServer() {
     });    // Display promotional message
     console.error('\n\x1b[36m╔════════════════════════════════════════════════════════════╗');
     console.error('║                                                            ║');
-    console.error('║  \x1b[1m\x1b[31mDuckDuckGo & IAsk AI Search MCP\x1b[0m\x1b[36m by \x1b[1m\x1b[33m@OEvortex\x1b[0m\x1b[36m       ║');
+    console.error('║  \x1b[1m\x1b[31mDuckDuckGo & AI Search MCP\x1b[0m\x1b[36m by \x1b[1m\x1b[33m@OEvortex\x1b[0m\x1b[36m            ║');
     console.error('║                                                            ║');
     console.error('║  \x1b[0m👉 Subscribe to \x1b[1m\x1b[37myoutube.com/@OEvortex\x1b[0m\x1b[36m for more tools!  ║');
     console.error('║                                                            ║');
@@ -101,7 +106,7 @@ async function startServer() {
     // Start the server with stdio transport
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('DuckDuckGo, IAsk AI & Monica Search MCP server started and listening on stdio');
+    console.error('DuckDuckGo, IAsk AI, Monica & Brave AI Search MCP server started and listening on stdio');
   } catch (error) {
     console.error('Failed to start server:', error);
     process.exit(1);
@@ -115,7 +120,7 @@ const versionFlag = args.includes('--version') || args.includes('-v');
 
 if (helpFlag) {
   console.log(`
-DuckDuckGo, IAsk AI & Monica Search MCP - A Model Context Protocol server for web search
+DuckDuckGo, IAsk AI, Monica & Brave AI Search MCP - A Model Context Protocol server for web search
 
 Usage:
   npx -y @oevortex/ddg_search@latest [options]
@@ -128,6 +133,7 @@ This MCP server provides the following tools:
   - web-search: Search the web using DuckDuckGo
   - iask-search: Search using IAsk AI for AI-generated responses
   - monica-search: Search using Monica AI for AI-generated responses
+  - brave-search: Search using Brave AI for AI-generated responses
 
 Created by @OEvortex
 Subscribe to youtube.com/@OEvortex for more tools and tutorials!
@@ -145,7 +151,7 @@ if (versionFlag) {
         const packageJson = JSON.parse(
           await readFile(new URL('../package.json', import.meta.url), 'utf8')
         );
-        console.log(`DuckDuckGo & IAsk AI Search MCP v${packageJson.version}\nCreated by @OEvortex - Subscribe to youtube.com/@OEvortex!`);
+        console.log(`DuckDuckGo & AI Search MCP v${packageJson.version}\nCreated by @OEvortex - Subscribe to youtube.com/@OEvortex!`);
         process.exit(0);
       } catch (err) {
         console.error('Error reading version information:', err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oevortex/ddg_search",
-  "version": "1.1.9",
+  "version": "1.2.1",
   "description": "A Model Context Protocol server for web search using DuckDuckGo and IAsk AI",
   "main": "src/index.js",
   "module": "src/index.ts",
@@ -15,7 +15,13 @@
     "oevortex-ddg-search": "bin/cli.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest --testPathPattern=src/__tests__/utils",
+    "test:integration": "jest --testPathPattern=src/__tests__/mcp-integration",
+    "test:tools": "jest --testPathPattern=src/__tests__/tools",
+    "test:all": "jest --coverage --verbose",
     "start": "node bin/cli.js",
     "prepublishOnly": "npm run lint",
     "lint": "echo \"No linting configured\"",
@@ -51,8 +57,13 @@
     "ws": "^8.18.3"
   },
   "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@jest/globals": "^29.7.0",
     "@types/node": "^24.3.0",
+    "babel-jest": "^29.7.0",
+    "jest": "^29.7.0",
     "tsx": "^4.20.4",
     "typescript": "^5.9.2"
   }
-}
+}

package/src/index.js

@@ -5,6 +5,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import { searchToolDefinition, searchToolHandler } from './tools/searchTool.js';
 import { iaskToolDefinition, iaskToolHandler } from './tools/iaskTool.js';
 import { monicaToolDefinition, monicaToolHandler } from './tools/monicaTool.js';
+import { braveToolDefinition, braveToolHandler } from './tools/braveTool.js';
 
 // Required: Export default createServer function for Smithery
 export default function createServer({ config } = {}) {
@@ -14,7 +15,8 @@ export default function createServer({ config } = {}) {
   const availableTools = [
     searchToolDefinition,
     iaskToolDefinition,
-    monicaToolDefinition
+    monicaToolDefinition,
+    braveToolDefinition
   ];
   
   console.log('Available tools:', availableTools.map(t => t.name));
@@ -56,6 +58,9 @@ export default function createServer({ config } = {}) {
         case 'monica-search':
           return await monicaToolHandler(args);
 
+        case 'brave-search':
+          return await braveToolHandler(args);
+
         default:
           throw new Error(`Tool not found: ${name}`);
       }

package/src/index.ts

@@ -5,6 +5,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import { searchToolDefinition, searchToolHandler } from './tools/searchTool.js';
 import { iaskToolDefinition, iaskToolHandler } from './tools/iaskTool.js';
 import { monicaToolDefinition, monicaToolHandler } from './tools/monicaTool.js';
+import { braveToolDefinition, braveToolHandler } from './tools/braveTool.js';
 
 // Required: Export default createServer function for Smithery
 export default function createServer({ config }: { config?: any } = {}) {
@@ -14,7 +15,8 @@ export default function createServer({ config }: { config?: any } = {}) {
   const availableTools = [
     searchToolDefinition,
     iaskToolDefinition,
-    monicaToolDefinition
+    monicaToolDefinition,
+    braveToolDefinition
   ];
   
   console.log('Available tools:', availableTools.map(t => t.name));
@@ -56,6 +58,9 @@ export default function createServer({ config }: { config?: any } = {}) {
         case 'monica-search':
           return await monicaToolHandler(args);
 
+        case 'brave-search':
+          return await braveToolHandler(args);
+
         default:
           throw new Error(`Tool not found: ${name}`);
       }

package/src/tools/braveTool.js

@@ -0,0 +1,63 @@
+import { searchBraveAI } from '../utils/search_brave_ai.js';
+
+/**
+ * Brave AI search tool definition
+ */
+export const braveToolDefinition = {
+  name: 'brave-search',
+  title: 'Brave AI Search',
+  description: 'AI-powered search using Brave Search AI Chat. Returns AI-generated responses based on web content.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: {
+        type: 'string',
+        description: 'The search query or question.'
+      },
+      enableResearch: {
+        type: 'boolean',
+        description: 'Enable deep research mode for more comprehensive responses.',
+        default: false
+      }
+    },
+    required: ['query']
+  },
+  annotations: {
+    readOnlyHint: true,
+    openWorldHint: false
+  }
+};
+
+/**
+ * Brave AI search tool handler
+ * @param {Object} params - The tool parameters
+ * @returns {Promise<Object>} - The tool result
+ */
+export async function braveToolHandler(params) {
+  const { query, enableResearch = false } = params;
+
+  console.log(`Searching Brave AI for: "${query}" (research: ${enableResearch})`);
+
+  try {
+    const result = await searchBraveAI(query, { enableResearch });
+    return {
+      content: [
+        {
+          type: 'text',
+          text: result || 'No results found.'
+        }
+      ]
+    };
+  } catch (error) {
+    console.error(`Error in Brave AI search: ${error.message}`);
+    return {
+      isError: true,
+      content: [
+        {
+          type: 'text',
+          text: `Error searching Brave AI: ${error.message}`
+        }
+      ]
+    };
+  }
+}

package/src/tools/searchTool.js

@@ -37,43 +37,43 @@ export const searchToolDefinition = {
  * @param {Object} params - The tool parameters
  * @returns {Promise<Object>} - The tool result
  */
-export async function searchToolHandler(params) {
-  const { query, numResults = 3, mode = 'short' } = params;
-  console.log(`Searching for: ${query} (${numResults} results, mode: ${mode})`);
-
-  const results = await searchDuckDuckGo(query, numResults, mode);
-  console.log(`Found ${results.length} results`);
-
-  // Format results as readable text, similar to other search tools
-  const formattedResults = results.map((result, index) => {
-    let formatted = `${index + 1}. **${result.title}**\n`;
-    formatted += `URL: ${result.url}\n`;
-    
-    if (result.displayUrl) {
-      formatted += `Display URL: ${result.displayUrl}\n`;
-    }
-    
-    if (result.snippet) {
-      formatted += `Snippet: ${result.snippet}\n`;
-    }
-    
-    if (mode === 'detailed' && result.description) {
-      formatted += `Content: ${result.description}\n`;
-    }
-    
-    if (result.favicon) {
-      formatted += `Favicon: ${result.favicon}\n`;
-    }
-    
-    return formatted;
-  }).join('\n');
-
-  return {
-    content: [
-      {
-        type: 'text',
-        text: formattedResults || 'No results found.'
-      }
-    ]
-  };
-}
+export async function searchToolHandler(params) {
+  const { query, numResults = 3, mode = 'short' } = params;
+  console.log(`Searching for: ${query} (${numResults} results, mode: ${mode})`);
+
+  const results = await searchDuckDuckGo(query, numResults, mode);
+  console.log(`Found ${results.length} results`);
+
+  // Format results as readable text, similar to other search tools
+  const formattedResults = results.map((result, index) => {
+    let formatted = `${index + 1}. **${result.title}**\n`;
+    formatted += `URL: ${result.url}\n`;
+    
+    if (result.displayUrl) {
+      formatted += `Display URL: ${result.displayUrl}\n`;
+    }
+    
+    if (result.snippet) {
+      formatted += `Snippet: ${result.snippet}\n`;
+    }
+    
+    if (mode === 'detailed' && result.description) {
+      formatted += `Content: ${result.description}\n`;
+    }
+    
+    if (result.favicon) {
+      formatted += `Favicon: ${result.favicon}\n`;
+    }
+    
+    return formatted;
+  }).join('\n');
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: formattedResults || 'No results found.'
+      }
+    ]
+  };
+}