multi-search-mcp by guptabhishek - MCP Server

MCP Search Server

This package exists to provide a unified MCP (Model Context Protocol) interface for multi-provider web search. It allows you to leverage the free monthly quota given by multiple search services (such as Google and Tavily) by automatically falling back between them, maximizing your available search capacity for automation and AI workflows.

Features

Supports Google Custom Search and Tavily Search.
Exposes a single MCP tool: search.
Allows specifying a provider directly or uses a priority-based fallback (default: Tavily, Google).
Standardizes search results into a common format.
Configurable via environment variables.

Getting Free API Credentials

Tavily

Go to Tavily and sign up for a free account.
After verifying your email, log in to your Tavily dashboard.
Navigate to the API section and generate a free API key.
Copy the API key and use it as TAVILY_API_KEY in your configuration.

Google Custom Search

Go to the Google Cloud Console and create a new project (or select an existing one).
Enable the Custom Search API for your project.
Go to the Custom Search Engine and create a new search engine.
- For "Sites to search", you can enter www.example.com (you can edit this later to search the entire web).
- After creation, go to the control panel of your search engine and enable "Search the entire web" in the "Sites to search" section.
Copy the Search Engine ID (CX) and use it as GOOGLE_CX.
In the Cloud Console, go to APIs & Services > Credentials and create an API key.
Use this API key as GOOGLE_API_KEY in your configuration.

Setup

After updating your configuration or credentials, run:

npm run build
npm start

Clone/Download: Get the server code.
Install Dependencies:
```
npm install
```

Configure API Keys (via MCP Client Settings):

Instead of using a .env file, you can configure the API keys and optional port directly within your MCP client's JSON settings (e.g., Cline's cline_mcp_settings.json).
Add or modify the server entry for mcp-search-server and provide the necessary keys in the env object:

{
  "servers": {
    // ... other servers ...

    "search": { // Or your chosen name for this server
      "autoApprove": [],
      "disabled": false, // Set to false to enable
      "timeout": 120,
      "command": "node", // Or the command to run the server
      "args": [
        // Path to the built server index file
        "/path/to/your/MCP/mcp-search-server/build/index.js"
      ],
      "env": {
        // Required API Keys
        "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",
        "GOOGLE_CX": "YOUR_GOOGLE_CUSTOM_SEARCH_ENGINE_ID",
        "BING_API_KEY": "YOUR_BING_SUBSCRIPTION_KEY", // Add if using Bing

        // Optional Port Override
        "PORT": "3002" // Example: run on port 3002 instead of default
      },
      "transportType": "stdio" // Assuming stdio transport
    }

    // ... other servers ...
  }
}

Replace the placeholder values (YOUR_..._KEY, /path/to/your/MCP/...) with your actual keys and the correct path to the built index.js file.
Ensure you provide keys for the providers you intend to use.

Running the Server

npm start

The server will start, typically on port 3001 (or the port specified in .env). It will print the available tool name and the status of loaded API keys.

MCP Tool: `search`

Description: Performs a web search using multiple providers (Tavily, Google, Bing) with priority fallback.
Input Schema:
- query (string, required): The search term.
- provider (string, optional, enum: ["google", "tavily"]): Specify a provider directly. If omitted, uses priority fallback.
- num_results (integer, optional, default: 10): Number of results desired (min: 1, max: 20).

Output: A JSON object containing an array of content objects, where each object represents a structured search result:

{
  "content": [
    {
      "type": "search_result", // Or another appropriate type
      "title": "Result Title",
      "link": "https://example.com/result",
      "snippet": "Description or snippet of the result.",
      "provider": "tavily" // Indicates which provider returned this result
    },
    // ... more results
  ]
}

Connecting to Cline (or other MCP clients)

Add the server command (e.g., node build/index.js) or connection details to your MCP client's configuration. Cline should then detect the search tool.

Modifying Provider Priority

Edit the PROVIDER_PRIORITY array in src/config.ts (and rebuild) to change the fallback order. The default is ['tavily', 'google'].