MCP WebSearch Server

MCP Server for web search and advanced web scraping. Uses SearchAPI.io for Google Search and AI Mode.

Quick Start

Option 1: Stdio (npx)

{
  "mcpServers": {
    "websearch": {
      "command": "npx",
      "args": ["-y", "mcp-websearch-server"],
      "env": {
        "SEARCHAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Option 2: HTTP Server (Streamable HTTP)

Run as HTTP server:

MCP_TRANSPORT=http PORT=3000 npx mcp-websearch-server

Then configure MCP client with API key in URL or header:

Option A: API key in URL query parameter

{
  "mcpServers": {
    "websearch": {
      "url": "http://localhost:3000/mcp?apikey=YOUR_KEY",
      "transport": "streamable-http"
    }
  }
}

Option B: API key in header

{
  "mcpServers": {
    "websearch": {
      "url": "http://localhost:3000/mcp",
      "transport": "streamable-http",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}

Option C: Server-side default key

MCP_TRANSPORT=http SEARCHAPI_KEY=default-key PORT=3000 npx mcp-websearch-server

The server implements MCP Streamable HTTP transport (spec 2025-03-26) with:

• Session management with Mcp-Session-Id headers

• SSE streaming for server-initiated messages

• Resumability support with Last-Event-ID

• Per-user API key support via query param or header

Get your API key at searchapi.io

Tools

Parameters

web_search

• query - Search query

• num_results - Number of results (1-20, default 10)

• page - Page number for pagination (1-10)

• time_period - Filter: last_hour, last_day, last_week, last_month, last_year

• site - Limit to specific site (e.g., "github.com")

ai_search

• query - Question or topic

• image_url - Optional image URL for visual questions

• location - Location for local queries

web_scrape

• url - URL to scrape

• selector - CSS selector (optional)

• extract_mode - text, markdown, or structured

• include_links - Include links in output

• max_length - Max content length (1000-50000)

get_links

• url - URL to extract links from

• filter - Text filter for URLs/anchors

scrape_multiple

• urls - Array of URLs (max 5)

• max_per_page - Max content per page (500-5000)

Deployment

PM2 (Production)

1. Edit ecosystem.config.js and set your SEARCHAPI_KEY

2. Run: npm run pm2:start

3. Check logs: npm run pm2:logs

Or manually:

MCP_TRANSPORT=http PORT=3000 SEARCHAPI_KEY=your-key pm2 start index.js --name mcp-websearch

Docker

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
ENV MCP_TRANSPORT=http PORT=3000
EXPOSE 3000
CMD ["node", "index.js"]

Roadmap

• Add Serper.dev provider support

• Add SerpAPI provider support

• Provider auto-fallback

License

MIT