feat: multi-provider search MCP server (v1.20.0)

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "sdlc",
-  "version": "1.19.1",
+  "version": "1.20.0",
   "description": "Comprehensive SDLC plugin with specialized agents, commands, and integrations for enhanced software development workflow",
   "author": {
     "name": "Ladislav Martincik",

.mcp.json

@@ -4,13 +4,15 @@
             "command": "npx",
             "args": ["-y", "@upstash/context7-mcp@latest"]
         },
-        "perplexity": {
+        "search": {
             "command": "bun",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/utils/perplexity-mcp/index.ts"],
+            "args": ["${CLAUDE_PLUGIN_ROOT}/utils/search-mcp/index.ts"],
             "env": {
               "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
-              "OPENROUTER_MODEL": "${OPENROUTER_MODEL:-perplexity/sonar-pro}"
+              "OPENROUTER_MODEL": "${OPENROUTER_MODEL:-perplexity/sonar-pro}",
+              "EXA_API_KEY": "${EXA_API_KEY}",
+              "BRAVE_API_KEY": "${BRAVE_API_KEY}"
             }
         }
     }
-}
+}

CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to the SDLC Plugin will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.20.0] - 2026-02-14
+
+### Added
+
+- **Multi-provider search MCP server** — unified `search_web` tool supporting Exa, Brave, and Perplexity via OpenRouter
+- **Provider adapters** with consistent error handling, timeout management, and response formatting
+- **Provider parameter validation** — cross-provider param misuse returns clear errors
+- **Automatic provider detection** from environment variables with priority cascade: Exa > Brave > Perplexity
+
+### Fixed
+
+- **Exa timeout memory leak** — `setTimeout` in `Promise.race` pattern now cleaned up via `finally` block
+- **Redundant `clearTimeout`** in Perplexity SSE stream error handler
+
+### Removed
+
+- **Old `perplexity-mcp/`** directory replaced by new `search-mcp/` implementation
+
 ## [1.19.1] - 2026-02-12
 
 ### Changed

README.md

@@ -416,12 +416,14 @@ Configure in `.mcp.json`:
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp@latest"]
     },
-    "perplexity": {
+    "search": {
       "command": "bun",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/utils/perplexity-mcp/index.ts"],
+      "args": ["${CLAUDE_PLUGIN_ROOT}/utils/search-mcp/index.ts"],
       "env": {
         "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
-        "OPENROUTER_MODEL": "${OPENROUTER_MODEL:-perplexity/sonar-pro}"
+        "OPENROUTER_MODEL": "${OPENROUTER_MODEL:-perplexity/sonar-pro}",
+        "EXA_API_KEY": "${EXA_API_KEY}",
+        "BRAVE_API_KEY": "${BRAVE_API_KEY}"
       }
     }
   }
@@ -458,8 +460,14 @@ sdlc-plugin/
 │   ├── tdd/SKILL.md             # TDD enforcement
 │   └── test/SKILL.md
 ├── utils/
-│   └── perplexity-mcp/
-│       └── index.ts         # Perplexity Sonar MCP server (via OpenRouter)
+│   └── search-mcp/
+│       ├── index.ts         # Multi-provider search MCP server
+│       ├── types.ts         # Shared types and helpers
+│       ├── format.ts        # Response formatter
+│       └── providers/
+│           ├── perplexity.ts # Perplexity/OpenRouter adapter
+│           ├── exa.ts       # Exa search adapter
+│           └── brave.ts     # Brave Search adapter
 ├── logs/                    # Hook execution logs
 ├── .mcp.json               # MCP server configuration
 ├── README.md

agents/web-search-researcher.md

@@ -1,7 +1,7 @@
 ---
 name: web-search-researcher
 description: Research specialist for finding accurate, relevant information from web sources using Sonar (via OpenRouter), WebSearch, Context7, and other tools with proper citations
-tools: WebSearch, WebFetch, TodoWrite, Read, Grep, Glob, Skill, LS, mcp__perplexity__search_web, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
+tools: WebSearch, WebFetch, TodoWrite, Read, Grep, Glob, Skill, LS, mcp__search__search_web, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
 color: yellow
 model: sonnet
 ---

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdlc-plugin",
-  "version": "1.19.1",
+  "version": "1.20.0",
   "description": "Comprehensive SDLC plugin with specialized agents, commands, and integrations",
   "private": true,
   "type": "module",
@@ -21,6 +21,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "exa-js": "^2.4.0",
     "zod": "^3.23.8"
   }
 }