Which integrations are available for this server?

Provides internet search using Brave Search API as an alternative search provider. Provides URL fetching with a fallback to Wikipedia API for QRATOR-protected Wikipedia mirrors, enabling content retrieval from Wikipedia. Provides internet search using Yandex Cloud Search API, returning results with title, URL, and description excerpts.

How do I use mcp-search-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-search-server search for latest AI breakthroughs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-search-server

by in40

Overview Schema Related Servers Score Discussions

Python

Remote

MCP Search Server

MCP-compliant server providing web search (Yandex Search API) and URL fetching capabilities over JSON-RPC 2.0. Includes a built-in monitoring dashboard with live log feed and request statistics.

Quick Start

Online (with internet)

pip install git+https://github.com/in40/mcp-search-server.git

Offline (air-gapped, no internet)

Prerequisites: Python 3.10+, pip.

Download

Two bundles available on the GitHub Releases page:

Bundle	Size	Playwright	Chromium
`mcp-search-server-offline.tar.gz`	21 MB	no	no
`mcp-search-server-offline-full.tar.gz`	330 MB	yes	yes

# Light (no browser automation):
curl -sL https://github.com/in40/mcp-search-server/releases/download/v2.2.0/mcp-search-server-offline.tar.gz -o mcp-search-server-offline.tar.gz

# Full (with Playwright + Chromium for JS-heavy sites):
curl -sL https://github.com/in40/mcp-search-server/releases/download/v2.2.0/mcp-search-server-offline-full.tar.gz -o mcp-search-server-offline-full.tar.gz

To rebuild yourself (e.g. for a different Python version):

git clone https://github.com/in40/mcp-search-server.git
cd mcp-search-server
bash scripts/build-offline.sh                    # light (21 MB)
bash scripts/build-offline.sh --with-playwright  # full (330 MB)

Deploy (on the air-gapped machine)

Light bundle:

tar xzf mcp-search-server-offline.tar.gz
cd offline
bash install.sh --venv ./venv

Full bundle (Playwright included):

tar xzf mcp-search-server-offline-full.tar.gz
cd offline
bash install.sh --venv ./venv
# install.sh automatically links bundled Chromium

Manual install (without the script)

pip install --no-index --find-links=./wheels ./wheels/mcp_search_server-*.whl

Configure & Run

export YANDEX_SEARCH_API_KEY="your-yandex-api-key"
export YANDEX_FOLDER_ID="your-yandex-folder-id"
export YANDEX_SEARCH_TYPE="SEARCH_TYPE_COM"  # or SEARCH_TYPE_RU
mcp-search-server

Related MCP server: EnriWeb

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     mcp-search-server                        │
│                                                             │
│  Port 8090              │  Port 8091                        │
│  MCP JSON-RPC 2.0       │  REST API           Dashboard     │
│  ┌───────────────────┐  │  ┌──────────────┐  ┌────────────┐ │
│  │ tools/list         │  │  │ POST /search │  │ GET /      │ │
│  │ tools/call         │  │  │ POST /fetch  │  │  (HTML UI) │ │
│  │  - internet_search │  │  │ GET /health  │  │            │ │
│  │  - fetch_url       │  │  │ GET /stats   │  │            │ │
│  └───────────────────┘  │  │ GET /logs     │  └────────────┘ │
│                         │  └──────────────┘                  │
│  In-memory log ring buffer (24h retention)                   │
└─────────────────────────────────────────────────────────────┘

Features

Search (Yandex Cloud Search API)

Primary search provider: Yandex Cloud Search API
Fallback: Brave Search API (configurable via SEARCH_PROVIDER)
Results include title, URL, description excerpts

URL Fetch (`fetch_url`)

Multi-layered fallback system:

requests library with Chrome UA headers (primary)
SSL fallback - retries without cert verification for broken cert chains
curl subprocess - bypasses some WAF/bot challenges (QRATOR, Cloudflare)
Playwright/Chromium - headless browser for JS-heavy sites
Wikipedia API - direct API for QRATOR-protected Wikipedia mirrors
Content extraction via trafilatura (HTML-to-Markdown)
Russian-language error messages for all failure modes

Dashboard (Port 8091)

Real-time stats: total requests, last-hour, errors, search vs fetch breakdown
Live log feed with auto-refresh (5s interval)
Per-request detail modal (full JSON)
Yandex search tab with timing and results
Themes: blue (default), orange (set DASHBOARD_THEME=orange)

Environment Variables

Variable	Required	Default	Description
`YANDEX_SEARCH_API_KEY`	Yes	(placeholder)	Yandex Cloud API key
`YANDEX_FOLDER_ID`	Yes	(placeholder)	Yandex Cloud folder ID
`YANDEX_SEARCH_TYPE`	No	`SEARCH_TYPE_COM`	`SEARCH_TYPE_RU` for Russian results
`SEARCH_PROVIDER`	No	`yandex`	`brave` to use Brave Search API
`BRAVE_SEARCH_API_KEY`	No	(placeholder)	Required if `SEARCH_PROVIDER=brave`
`PORT`	No	`8090`	MCP JSON-RPC server port
`DASHBOARD_PORT`	No	`8091`	Dashboard + REST API port
`LOG_RETENTION_HOURS`	No	`24`	Hours to keep request logs in memory
`API_KEYS_PATH`	No	`./api_keys.json`	Path to API keys file
`DASHBOARD_THEME`	No	(none)	Set to `orange` for orange theme

Authentication

Both MCP and Dashboard endpoints require X-API-Key header matching keys in api_keys.json:

{
    "keys": {
        "your-api-key-here": "read-write"
    }
}

MCP JSON-RPC API

`initialize`

{"jsonrpc": "2.0", "method": "initialize", "id": 1}

`tools/list`

Returns two tools: internet_search and fetch_url.

`tools/call`

internet_search

{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "internet_search",
        "arguments": { "query": "MCP protocol", "count": 5 }
    }
}

fetch_url

{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 3,
    "params": {
        "name": "fetch_url",
        "arguments": { "url": "https://example.com" }
    }
}

REST API (Dashboard Port)

Method	Path	Auth	Description
`GET`	`/health`	No	Health check
`GET`	`/stats`	X-API-Key	Aggregated statistics
`GET`	`/logs?type=&limit=`	X-API-Key	Request logs
`GET`	`/`	X-API-Key	Dashboard HTML UI
`POST`	`/api/search`	X-API-Key	JSON: `{"query": "...", "count": 5}`
`POST`	`/api/fetch`	X-API-Key	JSON: `{"url": "..."}`

Docker

Online build

FROM python:3.11-slim
RUN apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir \
    "mcp-search-server[playwright] @ git+https://github.com/in40/mcp-search-server.git" \
    && python -m playwright install --with-deps chromium
COPY api_keys.json .
ENV API_KEYS_PATH=/app/api_keys.json
CMD ["mcp-search-server"]

Offline build (air-gapped)

Copy mcp-search-server-offline.tar.gz to the build context, then:

FROM python:3.11-slim
RUN apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/*
COPY mcp-search-server-offline.tar.gz /tmp/
RUN cd /tmp && tar xzf mcp-search-server-offline.tar.gz && \
    pip install --no-index --find-links=/tmp/offline/wheels /tmp/offline/wheels/mcp_search_server-*.whl && \
    rm -rf /tmp/mcp-search-server-offline.tar.gz /tmp/offline
COPY api_keys.json .
ENV API_KEYS_PATH=/app/api_keys.json
CMD ["mcp-search-server"]

Development

Online

git clone https://github.com/in40/mcp-search-server.git
cd mcp-search-server
python -m venv .venv && source .venv/bin/activate
pip install -e ".[all]"
playwright install --with-deps chromium
mcp-search-server

Offline

tar xzf mcp-search-server-offline.tar.gz
cd offline
bash install.sh --venv ./venv
source ./venv/bin/activate
mcp-search-server

License

Apache 2.0

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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/in40/mcp-search-server'

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