What this kind of tool is for
- Let your agent search the web or a document set and cite what it found.
- Pull structured facts out of pages instead of copy-pasting by hand.
- Track changes on a topic over days without re-reading everything.
How to compare servers like this
- Source coverage:
- Check which engines, sites, or document types the tool can actually reach.
- Citation behavior:
- Prefer tools that return links you can open, not just summarized claims.
- Terms of service:
- Some sources forbid automated access; make sure the tool stays inside them.
- Maintenance signal:
- Scrapers break silently when pages change; recent commits are the best proxy.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the MCP Retrieval MCP server?
Local Go MCP server: DuckDuckGo/Bing web + image search, readability scraping to Markdown.
How to install MCP Retrieval
Copy-paste configuration for popular MCP clients.
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.
{
"mcpServers": {
"mcp-retrieval": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/role1776/mcp-retrieval:0.1.7"
],
"env": {
"MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
"MCP_NAME": "<YOUR_MCP_NAME>",
"MCP_PATH": "<YOUR_MCP_PATH>",
"SERVER_PORT": "<YOUR_SERVER_PORT>",
"SERVER_READ_TIMEOUT": "<YOUR_SERVER_READ_TIMEOUT>",
"SERVER_WRITE_TIMEOUT": "<YOUR_SERVER_WRITE_TIMEOUT>",
"LOG_MODE": "<YOUR_LOG_MODE>",
"MAX_IDLE_CONNS_PER_HOST": "<YOUR_MAX_IDLE_CONNS_PER_HOST>",
"MAX_QUERIES": "<YOUR_MAX_QUERIES>",
"DEFAULT_RESULTS": "<YOUR_DEFAULT_RESULTS>",
"MAX_RESULTS": "<YOUR_MAX_RESULTS>",
"DEFAULT_IMAGES": "<YOUR_DEFAULT_IMAGES>",
"MAX_IMAGES": "<YOUR_MAX_IMAGES>",
"DEFAULT_TIMEOUT_MS": "<YOUR_DEFAULT_TIMEOUT_MS>",
"MIN_TIMEOUT_MS": "<YOUR_MIN_TIMEOUT_MS>",
"MAX_TIMEOUT_MS": "<YOUR_MAX_TIMEOUT_MS>",
"DEFAULT_DOCUMENT_CHARS": "<YOUR_DEFAULT_DOCUMENT_CHARS>",
"MAX_DOCUMENT_CHARS": "<YOUR_MAX_DOCUMENT_CHARS>",
"PROXY_SCHEME": "<YOUR_PROXY_SCHEME>",
"PROXY_HOST": "<YOUR_PROXY_HOST>",
"PROXY_PORT": "<YOUR_PROXY_PORT>",
"PROXY_LOGIN": "<YOUR_PROXY_LOGIN>",
"PROXY_PASSWORD": "<YOUR_PROXY_PASSWORD>"
}
}
}
}Related MCP servers

X (Twitter)
Search, read and publish X posts and manage users, lists and media via the X API v2.

Compare Korean public notices (HWP/HWPX): changed eligibility, documents, deadlines, with evidence

Notanda (Beta)
Beta: OpenAlex literature search and local evidence retrieval. External acceptance test pending.
BYOK Reddit/YouTube research CLI with a tamper-evident audit log and an MCP server.

io.github.RoleModel/optics-mcp
MCP Server for Optics Design System documentation and token usage.
AI-powered hotel search, comparison, and booking for agents and MCP clients—free, unlimited calls, 2M+ hotels worldwide.

