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 Source Related Servers Score 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. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityStale

ResponsivenessNo issues

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.

Related MCP Connectors

mcp-serpOAuth
io.github.AceDataCloud
MCP server for Google search results via SERP API
Search Browser Automation Web Scraping
21
yandex-searchOAuth
io.github.johnisanerd
Yandex search results, images, and SERP data via the Apify Yandex Search Scraper, hosted MCP.
Web Scraping Search
21
mcp A
ai.llmse
Public MCP server for the LLM Search Engine
Search RAG Systems Developer Tools
102
mcp-webextratorOAuth
io.github.AceDataCloud
MCP server for web extraction and rendering via AceDataCloud WebExtrator
Web Scraping Browser Automation
2

Related MCP Servers

serp-it
Search Browser Automation Web Scraping
luka-dev
A
license
Not graded
quality
C
maintenance
An MCP server that aggregates web search results from multiple engines and optionally renders pages to Markdown, providing a unified search interface.
Updated 7 months ago (2026-01-31 23:31 UTC)
12
3
ISC
Web Search MCP
Search Web Scraping Browser Automation
thehappyboy
A
license
A
quality
B
maintenance
Multi-source web search MCP server with RRF fusion, 4-layer URL extraction, and provider health tracking.
Updated 23 days ago (2026-08-16 09:44 UTC)
6
26
MIT
scrapesearch-mcp
tonmoy-dhroubo
F
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 7 months ago (2026-01-25 21:53 UTC)
1
-
web-mcp
Search Web Scraping Browser Automation
Chang-Tong
A
license
Not graded
quality
B
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 6 days ago (2026-09-02 16:43 UTC)
4
MIT

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
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

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