Yandex search MCP on .NET with AOT compilation
Yandex Search MCP Server (.NET)
A .NET 10 Yandex search MCP server with native AOT compilation, page-to-Markdown conversion and regex search
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- Runs a binary that searches via Yandex Search API and downloads arbitrary web pages
- Logs queries and the start of responses next to the executable
Install
- Works in
- Services
Manual install
git clone <repo-url>
cd yandex-search-mcp-dotnet
dotnet publish -c ReleaseBuilds the native AOT binary; point your MCP client config at the resulting path.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a binary that searches via Yandex Search API and downloads arbitrary web pages
- Logs queries and the start of responses next to the executable
This is third-party code. Review the repository files before installing.
What it does
The server wraps the Yandex Search API v2 and offers three tools: web_search for querying with a Russian or English region choice, fetch for downloading any web page and converting it to Markdown with settings for links, images, timeout and a character range, and fetch_with_regex, which additionally searches the resulting Markdown with a regular expression. The server compiles to a native AOT binary with no .NET runtime needed, supports stdio and HTTP transport, strips Yandex's <hlword> highlight tags from XML markup, and can route through a proxy when the target page is unreachable directly.
Who it is for. For .NET developers who want a lightweight native Yandex search binary with no runtime install on the target machine.
Good fit when
- You want one AOT binary for search and page-to-Markdown fetching without Node.js or Python
- You need to regex-search directly inside a fetched page's content
- You need both stdio and HTTP versions of the same server depending on the client
Not a fit when
- You cannot build or run the .NET 10 SDK or the binary
- You need region support beyond Russian and English
Example request
Find the article about the new law, fetch it and pull out every paragraph mentioning the tax rateMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
YANDEX_CLOUD_API_KEYrequired, secret- Yandex Cloud Search API key
YANDEX_CLOUD_FOLDER_IDrequired- Yandex Cloud folder ID
Limitations
The web_search tool only accepts the ru or en region. Requires a Yandex Cloud account with Search API access; the key and folder ID are passed as command-line arguments, not only as environment variables. All tool calls are logged to a file next to the executable.
How to disable. Remove the yandex-search block from your MCP client config and stop the server process if it runs in HTTP mode.
FAQ
Do I need the .NET runtime on the target machine?
No, an AOT publish produces a native binary and the runtime is not required.
Can I search in languages other than Russian?
Yes, the web_search tool takes a search_region parameter with ru or en values.
Discussion
No questions or reviews yet.
Related
All Yandex Search toolsYandex Search API v2 MCP server
yandex-search-mcp
A self-hosted MCP for Yandex Search API v2: web, image and generative search across all six Yandex indexes
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
Yandex search MCP server in TypeScript
yandex-search-mcp
A TypeScript MCP server for the Yandex Search API with its own result parser and tests
Yandex and Google search MCP server
web-compass
An MCP web-search and content-extraction server via Yandex and Google on top of SerpAPI, geared toward RU/CIS results
Yandex's official MCP server for web search via Yandex Search API: results with sources and a generative answer
Yandex Search MCP via browser automation
yandex-search-mcp
An unofficial Playwright-based MCP server that searches Yandex through a browser with authenticated cookies, extracting and ranking page content for an agent
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yandex search MCP on .NET with AOT compilation (this card) | no | API key | 0 | |
| Yandex Search MCP via browser automation | no | not required | 4 | searches Yandex through a browser with cookies |
| Yandex and Google search MCP server | no | not required | 1 | search through Yandex and Google on SerpAPI |
| Yandex search MCP server in TypeScript | no | API key | 0 | in TypeScript, with its own results parser |
README in short
The README lists capabilities: search, fetch to Markdown, two-region support, AOT build, stdio and HTTP transport, and XML markup cleanup, gives a quick start with environment variables and CLI arguments, an argument table, MCP client configs for stdio and HTTP, detailed descriptions of the three tools with parameters, and the log format.