MCP Retrieval MCP server

by Role1776·io.github.Role1776/mcp-retrieval·v0.1.10·23 stars

No reviews yet

Local Go MCP server: DuckDuckGo/Bing web + image search, readability scraping to Markdown.

B73/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B73/100

full report

Adoption

Growing

23 stars

Reviews

Write one

Nobody has reviewed MCP Retrieval yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

MCP Retrieval tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it

no findings

–Code scanpackage could not be scannedn/a
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 10 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 73/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How MCP Retrieval compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 73/100; higher than 42% of 3,471 Web search servers
GitHub stars: 23; more than 90% of 1,788 Web search servers

Release history: 4 versions in the registry since 2026-08-17, latest 2026-10-24, typically one every 15 days.

Install MCP Retrieval in Claude Code, Cursor or VS Code

claude mcp add mcp-retrieval -- docker run -i --rm ghcr.io/role1776/mcp-retrieval:0.1.10

Add to Cursor

What the publisher says

From the MCP Retrieval repository's README, as published. We do not edit it. Read it on GitHub

mcp-retrieval

An MCP server that gives an LLM three web tools: search, image search, and page scraping — no API keys required.

Tools · Quick start · Configuration · Retrieval engine · Architecture · Contributing

What it is

mcp-retrieval is a Model Context Protocol server written in Go. It exposes web retrieval capabilities to any MCP-compatible client (Claude Desktop, IDE agents, custom LLM apps) as three read-only tools. Under the hood it uses the retrieval-go library to search the web and fetch pages, returning results as clean Markdown ready to hand to a model.

The library needs no API keys: web search goes through DuckDuckGo Lite, image search through Bing Images, and page fetching runs the HTML through a readability extractor before converting it to Markdown. To stay reliable against bot protection it impersonates real browsers at the TLS level and can rotate both browser fingerprints and proxies — see Retrieval engine.

Both transports the MCP SDK supports are available and expose the identical tool set:

stdio — the client launches the binary and talks over stdin/stdout (the default, ideal for desktop clients).
http — a long-running streamable HTTP server (useful for remote/shared deployments).

Tools

All three are annotated as read-only. Each tool returns a structured JSON payload that matches its output schema; the SDK mirrors the same JSON into the text content block for clients that do not read structuredContent.

web_search

websearchimages

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

MCP Retrieval: common questions

Is MCP Retrieval MCP server safe?: Mostly: it is graded B (73/100). Read the MCP Retrieval safety report
How do I install MCP Retrieval?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does MCP Retrieval need an API key?: Yes. The registry entry asks for PROXY_LOGIN, PROXY_PASSWORD.
Is MCP Retrieval maintained?: The last commit was 12 days ago (2026-10-24). The latest release is v0.1.10.
What can I use instead of MCP Retrieval?: Servers from other publishers that do the same job: Brave Search MCP server, webclaw MCP server and searxNcrawl MCP server. Compare all MCP Retrieval alternatives.
How does MCP Retrieval compare with other Web search MCP servers?: safety score 73/100 (higher than 42% of 3,471 Web search servers); github stars 23 (more than 90% of 1,788 Web search servers). Full comparison.

Alternatives to MCP Retrieval

Same job from other publishers: the closest match first, then the best rated.

All MCP Retrieval alternatives →

Brave Search
Brave Search MCP Server: web results, images, videos, rich results, AI summaries, and more.
not reviewed
Established
A
webclaw
Web scraping, search, crawling, structured extraction and research for AI agents.
not reviewed
Established
A
searxNcrawl
Web search via SearXNG and/or You.com, plus clean Markdown crawling via Crawl4AI. Self-hosted.
not reviewed
Established
A
Brave
Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…
not reviewed
Established
A
Zotero MCP
Search, read, annotate, and add to your Zotero research library, local or web.
not reviewed
Widely used
B

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 73/100
Stars: 23
Downloads/wk: –
Price: Free
Licence: MIT
Transport: Local · mixed
Version: 0.1.10
Category: Web search
Last release: 2026-10-24

Credentials it needs

MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.
MCP_TRANSPORTstdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAMEServer name reported in the MCP initialize handshake.
MCP_PATHHTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORTTCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUTHTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUTHTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODElocal (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOSTIdle connections the outbound HTTP client keeps per host.
MAX_QUERIESMaximum queries or URLs accepted in one call.
DEFAULT_RESULTSSnippets returned per query when the call does not ask for a count.
MAX_RESULTSUpper bound for snippets per query.
DEFAULT_IMAGESImages returned per query when the call does not ask for a count.
MAX_IMAGESUpper bound for images per query.
DEFAULT_TIMEOUT_MSPer-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MSLowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MSHighest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARSCharacters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARSUpper bound for characters kept per scraped page.
PROXY_SCHEMEOutbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOSTOutbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORTOutbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGINsecretOutbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORDsecretOutbound proxy password. Required when PROXY_HOST is set.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/role1776-mcp-retrieval.svg)](https://mcp.market/server/role1776-mcp-retrieval)

How the badge works