SkillFoxx

Yandex search MCP server with offline install

MCP Search Server

A search MCP server on the Yandex Cloud Search API with a monitoring dashboard, Brave fallback and an offline bundle for air-gapped networks

  • 0 ★ on the repository
  • Last commit
  • Apache-2.0
MCP server

Extended access

Why this level

  • Runs a Python server that searches via Yandex Search API and Brave
  • fetch_url downloads pages with curl and Playwright with Chromium, getting past some WAF protection
All reasons and checks
Russian stack

in40/mcp-search-serverAuthor:in40

Install

Manual install

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

Online install when internet access is available.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs a Python server that searches via Yandex Search API and Brave
  • fetch_url downloads pages with curl and Playwright with Chromium, getting past some WAF protection

This is third-party code. Review the repository files before installing.

What it does

The server exposes two JSON-RPC 2.0 tools: internet_search built on the Yandex Cloud Search API with a Brave Search API fallback, and fetch_url with a multi-layer fallback chain, requests with Chrome UA headers, an SSL-skip retry, curl to bypass some WAFs, Playwright for JS-heavy pages, and a dedicated path for QRATOR-protected Wikipedia mirrors. Page content is extracted to markdown via trafilatura. A separate web dashboard on port 8091 shows request statistics, a live auto-refreshing log, and per-request detail. For air-gapped networks there are offline bundles: a 21 MB light one with no browser and a 330 MB full one with Playwright and Chromium, including a ready Dockerfile for Astra Linux.

Who it is for. For teams that need Yandex-backed search with monitoring and the ability to deploy the server on an air-gapped network with no internet access.

Good fit when

  • You need to deploy on an air-gapped network or on the certified Russian OS Astra Linux
  • A live monitoring dashboard for requests and logs matters, not just console output
  • You want a Brave fallback when the Yandex Cloud Search API is unavailable

Not a fit when

  • You only want stdio with no REST and no dashboard: this is a standalone app with two ports
  • You do not want to set up an X-API-Key and an api_keys.json file for authorization

Example request

Find the latest news about changes to taxi legislation and open the full text of the first article

MCP

Transport
stdio, http
Authentication
API key

Environment variables

YANDEX_SEARCH_API_KEY required, secret
Yandex Cloud key for the Search API
YANDEX_FOLDER_ID required
Yandex Cloud folder ID
YANDEX_SEARCH_TYPE
SEARCH_TYPE_COM by default, SEARCH_TYPE_RU for Russian results
SEARCH_PROVIDER
yandex by default, brave switches to the Brave Search API

Limitations

The YANDEX_SEARCH_API_KEY and YANDEX_FOLDER_ID variables of a Yandex Cloud service account are required. The full offline bundle weighs 330 MB because of the bundled Chromium. MCP and dashboard authorization go through an X-API-Key header and a local api_keys.json file that you maintain yourself.

How to disable. Stop the mcp-search-server process and remove its address from your MCP client configuration.

FAQ

Can it be deployed with no internet?

Yes, the releases page has offline bundles with local wheels, a light one with no browser and a full one with Playwright and Chromium.

What if a site blocks the request?

fetch_url tries requests, then a retry without SSL verification, then curl to bypass WAFs, then Playwright for JS-heavy pages, in sequence.

Discussion

No questions or reviews yet.

All Yandex Search tools
Russian stack

A self-hosted MCP for Yandex Search API v2: web, image and generative search across all six Yandex indexes

MCP serverExtended access4
Russian stack

An unofficial Playwright-based MCP server that searches Yandex through a browser with authenticated cookies, extracting and ranking page content for an agent

MCP serverBroad access4
Russian stack

An MCP web-search and content-extraction server via Yandex and Google on top of SerpAPI, geared toward RU/CIS results

MCP serverExtended access1

Yandex Search API MCP with deferred search

Yandex Search MCP Server (Async Mode)

Russian stack

A fork of Yandex's official server defaulting to deferred async search, cutting Search API cost by up to 94%

MCP serverExtended access

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Yandex search MCP server with offline install (this card)noAPI key0
Yandex Search MCP via browser automationnonot required4searches Yandex through a browser with cookies
Yandex and Google search MCP servernonot required1search through Yandex and Google on SerpAPI
Yandex search MCP server in TypeScriptnoAPI key0in TypeScript, with its own results parser

README in short

The README shows online and offline installs with ready bundles of different sizes, explains the architecture with separate ports for MCP JSON-RPC, the REST API and the dashboard, gives an environment variable table, the X-API-Key authorization scheme, and Dockerfile examples for a standard Debian image and for the certified Astra Linux.

README badge

Report a problem