Skip to main content
Glama
zerox2f

Web Search MCP Remote Server

by zerox2f
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Web Search MCP Remote Server

Remote HTTP/SSE MCP server for web search with full page content extraction, search summaries, and single page content extraction. Built on top of mrkrsl/web-search-mcp, extended with HTTP/SSE transport, API key authentication, and Docker deployment.

Features

  • Dual Transport: stdio (local) + HTTP/SSE (remote)

  • API Key Auth: secure remote access via SERVICE_API_KEY

  • Docker Ready: docker compose up for single-command deployment

  • Same Tools: full-web-search, get-web-search-summaries, get-single-web-page-content

  • Multi-Engine Search: Bing → Brave → DuckDuckGo

  • Full Content Extraction: concurrent page fetch with Playwright + axios fallback

Related MCP server: Deep Search MCP Server

Quick Start with Docker

# 1. Clone
git clone https://github.com/zerox2f/web-search-mcp-remote.git
cd web-search-mcp-remote

# 2. Create .env
echo "SERVICE_API_KEY=your-secret-key" > .env

# 3. Start
docker compose up --build

Server runs at http://127.0.0.1:3000 (health: /health, SSE: /mcp).

mcp.json Configuration for LLM Clients

HTTP/SSE (Remote / Docker)

{
  "mcpServers": {
    "web-search-remote": {
      "url": "http://127.0.0.1:3000/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer your-secret-key"
      }
    }
  }
}

stdio (Local)

{
  "mcpServers": {
    "web-search-local": {
      "command": "node",
      "args": ["/path/to/web-search-mcp-remote/dist/index.js"],
      "env": {
        "MAX_CONTENT_LENGTH": "50000",
        "BROWSER_HEADLESS": "true"
      }
    }
  }
}

Environment Variables

Variable

Default

Description

SERVICE_API_KEY

(required in HTTP mode)

API key for remote access

HOST

127.0.0.1

Bind address

PORT

3000

Server port

MAX_CONTENT_LENGTH

500000

Max chars per page

BROWSER_HEADLESS

true

Headless browser

MAX_BROWSERS

3

Browser pool size

DEFAULT_TIMEOUT

6000

Request timeout (ms)

BROWSER_FALLBACK_THRESHOLD

3

Axios failures before browser fallback

Project Structure

web-search-mcp-remote/
├── src/
│   ├── index.ts                  # stdio entry point + tool registration
│   ├── http-server-entry.ts      # HTTP/SSE entry point
│   ├── http-server.ts            # Express + SSEServerTransport
│   ├── auth.ts                   # API key middleware
│   ├── search-engine.ts          # Multi-engine search
│   ├── enhanced-content-extractor.ts
│   ├── browser-pool.ts
│   ├── types.ts
│   └── utils.ts
├── Dockerfile
├── docker-compose.yml
├── docs/DOCUMENTATION.md
└── PLAN.md

Development

# Install deps
npm install
npx playwright install

# Run stdio mode
npm run dev:stdio

# Run HTTP/SSE mode
SERVICE_API_KEY=secret npm run dev:remote

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zerox2f/web-search-mcp-remote'

If you have feedback or need assistance with the MCP directory API, please join our Discord server