Home › Search & Research › MCP Retrieval

MCP Retrieval

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

Go Local macOSWindowsLinux

★ 23 stars Last pushed 2026-10-24 License: MIT

View repository → Website →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (oci)

docker run -i --rm -e PROXY_LOGIN=<YOUR_VALUE> -e PROXY_PASSWORD=<YOUR_VALUE> ghcr.io/role1776/mcp-retrieval:0.1.10

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-retrieval": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXY_LOGIN=<YOUR_VALUE>",
        "-e",
        "PROXY_PASSWORD=<YOUR_VALUE>",
        "ghcr.io/role1776/mcp-retrieval:0.1.10"
      ]
    }
  }
}

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.

Package (mcpb 0.1.10)

Package: mcpb https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/mcp-retrieval_0.1.10_darwin_amd64.mcpb

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.

Package (mcpb 0.1.10)

Package: mcpb https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/mcp-retrieval_0.1.10_darwin_arm64.mcpb

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.

Package (mcpb 0.1.10)

Package: mcpb https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/mcp-retrieval_0.1.10_linux_amd64.mcpb

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.

Package (mcpb 0.1.10)

Package: mcpb https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/mcp-retrieval_0.1.10_linux_arm64.mcpb

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.

Package (mcpb 0.1.10)

Package: mcpb https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/mcp-retrieval_0.1.10_windows_amd64.mcpb

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.

Package (mcpb 0.1.10)

Package: mcpb https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/mcp-retrieval_0.1.10_windows_arm64.mcpb

MCP_TRANSPORT — stdio (client spawns the process) or http (streamable HTTP listener).
MCP_NAME — Server name reported in the MCP initialize handshake.
MCP_PATH — HTTP path the MCP endpoint is served on. Used only when MCP_TRANSPORT=http.
SERVER_PORT — TCP port to listen on. Used only when MCP_TRANSPORT=http.
SERVER_READ_TIMEOUT — HTTP read timeout as a Go duration. Used only when MCP_TRANSPORT=http.
SERVER_WRITE_TIMEOUT — HTTP write timeout as a Go duration. Used only when MCP_TRANSPORT=http.
LOG_MODE — local (text, debug) or prod (JSON, info). Logs go to stderr.
MAX_IDLE_CONNS_PER_HOST — Idle connections the outbound HTTP client keeps per host.
MAX_QUERIES — Maximum queries or URLs accepted in one call.
DEFAULT_RESULTS — Snippets returned per query when the call does not ask for a count.
MAX_RESULTS — Upper bound for snippets per query.
DEFAULT_IMAGES — Images returned per query when the call does not ask for a count.
MAX_IMAGES — Upper bound for images per query.
DEFAULT_TIMEOUT_MS — Per-call timeout in milliseconds when the call does not request one.
MIN_TIMEOUT_MS — Lowest timeout a call may request, in milliseconds.
MAX_TIMEOUT_MS — Highest timeout a call may request, in milliseconds.
DEFAULT_DOCUMENT_CHARS — Characters kept per scraped page when the call does not ask for a limit.
MAX_DOCUMENT_CHARS — Upper bound for characters kept per scraped page.
PROXY_SCHEME — Outbound proxy scheme. Optional; set all five PROXY_* variables or none.
PROXY_HOST — Outbound proxy host. Enables per-request rotating proxy sessions.
PROXY_PORT — Outbound proxy port. Required when PROXY_HOST is set.
PROXY_LOGIN secret — Outbound proxy username. Required when PROXY_HOST is set.
PROXY_PASSWORD secret — Outbound proxy password. Required when PROXY_HOST is set.