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?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

mcp-search-server

by in40

Overview Schema Source Related Servers Discussions Admin

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: Web Search MCP

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 choose your base image:

Debian/Ubuntu-based (standard):

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/wheels /tmp/wheels/mcp_search_server-*.whl && \
    rm -rf /tmp/mcp-search-server-offline.tar.gz /tmp/wheels /tmp/install.sh
COPY api_keys.json .
ENV API_KEYS_PATH=/app/api_keys.json
CMD ["mcp-search-server"]

Astra Linux (certified Russian OS):

FROM registry.astralinux.ru/library/astra/ubi18:1.8.6
RUN apt-get update && apt-get install -y --no-install-recommends \
    curl \
    git \
    python3 \
    python3-pip \
    python3.11-venv \
    && 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 && \
    python3 -m venv /opt/venv && \
    /opt/venv/bin/pip install --no-index --find-links=/tmp/wheels /tmp/wheels/mcp_search_server-*.whl && \
    rm -rf /tmp/mcp-search-server-offline.tar.gz /tmp/wheels /tmp/install.sh
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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mcp-serp
io.github.AceDataCloud
MCP server for Google search results via SERP API
Search Browser Automation Web Scraping
21
https://serp.mcp.acedata.cloud/mcp
SearchPipeA
tech.searchpipe
Web search API and MCP server for developers building AI agents.
Search Browser Automation Agent Orchestration
31
https://searchpipe.tech/mcp/
Argosor — Unified SEO, SERP, Clean Markdown & GEO (AI Citation Visibility) MCP ServerA
com.argosor
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Developer Tools Marketing Social Media
151
https://argosor.com/mcp
yandex-search
io.github.johnisanerd
Yandex search results, images, and SERP data via the Apify Yandex Search Scraper, hosted MCP.
Web Scraping Search
21
https://mcp.apify.com/?tools=johnvc/Scrape-Yandex

Related MCP Servers

serp-it
Search Browser Automation Web Scraping
luka-dev
A
license
Not graded
quality
D
maintenance
An MCP server that aggregates web search results from multiple engines and optionally renders pages to Markdown, providing a unified search interface.
Updated 9 months ago (2026-01-31 23:31 UTC)
10 npm
3
ISC
Web Search MCP
Search Web Scraping Browser Automation
thehappyboy
A
license
A
quality
D
maintenance
Multi-source web search MCP server with RRF fusion, 4-layer URL extraction, and provider health tracking.
Updated 3 months ago (2026-08-16 09:44 UTC)
6
20 npm
MIT
scrapesearch-mcp
tonmoy-dhroubo
A
license
Not graded
quality
D
maintenance
MCP server that provides web search scraping from DuckDuckGo (with Mojeek fallback) and URL content fetching as markdown/text or raw HTML.
Updated 10 months ago (2026-01-25 21:53 UTC)
1
ISC
web-mcp
Search Web Scraping Browser Automation
Chang-Tong
A
license
Not graded
quality
C
maintenance
MCP server for multi-engine web search and web page fetching, supporting parallel search, content extraction, and optional LLM-powered search summarization and deep search.
Updated 2 months ago (2026-09-02 16:43 UTC)
5
MIT