MCP Retrieval

io.github.Role1776/mcp-retrieval · v0.1.10

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

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add mcp-retrieval -e MCP_TRANSPORT=<MCP_TRANSPORT> -e MCP_NAME=<MCP_NAME> -e MCP_PATH=<MCP_PATH> -e SERVER_PORT=<SERVER_PORT> -e SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> -e SERVER_WRITE_TIMEOUT=<SERVER_WRITE_TIMEOUT> -e LOG_MODE=<LOG_MODE> -e MAX_IDLE_CONNS_PER_HOST=<MAX_IDLE_CONNS_PER_HOST> -e MAX_QUERIES=<MAX_QUERIES> -e DEFAULT_RESULTS=<DEFAULT_RESULTS> -e MAX_RESULTS=<MAX_RESULTS> -e DEFAULT_IMAGES=<DEFAULT_IMAGES> -e MAX_IMAGES=<MAX_IMAGES> -e DEFAULT_TIMEOUT_MS=<DEFAULT_TIMEOUT_MS> -e MIN_TIMEOUT_MS=<MIN_TIMEOUT_MS> -e MAX_TIMEOUT_MS=<MAX_TIMEOUT_MS> -e DEFAULT_DOCUMENT_CHARS=<DEFAULT_DOCUMENT_CHARS> -e MAX_DOCUMENT_CHARS=<MAX_DOCUMENT_CHARS> -e PROXY_SCHEME=<PROXY_SCHEME> -e PROXY_HOST=<PROXY_HOST> -e PROXY_PORT=<PROXY_PORT> -e PROXY_LOGIN=<PROXY_LOGIN> -e PROXY_PASSWORD=<PROXY_PASSWORD> -- docker run -i --rm ghcr.io/role1776/mcp-retrieval:0.1.10

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-retrieval": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/role1776/mcp-retrieval:0.1.10"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "MCP_NAME": "<MCP_NAME>",
        "MCP_PATH": "<MCP_PATH>",
        "SERVER_PORT": "<SERVER_PORT>",
        "SERVER_READ_TIMEOUT": "<SERVER_READ_TIMEOUT>",
        "SERVER_WRITE_TIMEOUT": "<SERVER_WRITE_TIMEOUT>",
        "LOG_MODE": "<LOG_MODE>",
        "MAX_IDLE_CONNS_PER_HOST": "<MAX_IDLE_CONNS_PER_HOST>",
        "MAX_QUERIES": "<MAX_QUERIES>",
        "DEFAULT_RESULTS": "<DEFAULT_RESULTS>",
        "MAX_RESULTS": "<MAX_RESULTS>",
        "DEFAULT_IMAGES": "<DEFAULT_IMAGES>",
        "MAX_IMAGES": "<MAX_IMAGES>",
        "DEFAULT_TIMEOUT_MS": "<DEFAULT_TIMEOUT_MS>",
        "MIN_TIMEOUT_MS": "<MIN_TIMEOUT_MS>",
        "MAX_TIMEOUT_MS": "<MAX_TIMEOUT_MS>",
        "DEFAULT_DOCUMENT_CHARS": "<DEFAULT_DOCUMENT_CHARS>",
        "MAX_DOCUMENT_CHARS": "<MAX_DOCUMENT_CHARS>",
        "PROXY_SCHEME": "<PROXY_SCHEME>",
        "PROXY_HOST": "<PROXY_HOST>",
        "PROXY_PORT": "<PROXY_PORT>",
        "PROXY_LOGIN": "<PROXY_LOGIN>",
        "PROXY_PASSWORD": "<PROXY_PASSWORD>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-retrieval": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/role1776/mcp-retrieval:0.1.10"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "MCP_NAME": "<MCP_NAME>",
        "MCP_PATH": "<MCP_PATH>",
        "SERVER_PORT": "<SERVER_PORT>",
        "SERVER_READ_TIMEOUT": "<SERVER_READ_TIMEOUT>",
        "SERVER_WRITE_TIMEOUT": "<SERVER_WRITE_TIMEOUT>",
        "LOG_MODE": "<LOG_MODE>",
        "MAX_IDLE_CONNS_PER_HOST": "<MAX_IDLE_CONNS_PER_HOST>",
        "MAX_QUERIES": "<MAX_QUERIES>",
        "DEFAULT_RESULTS": "<DEFAULT_RESULTS>",
        "MAX_RESULTS": "<MAX_RESULTS>",
        "DEFAULT_IMAGES": "<DEFAULT_IMAGES>",
        "MAX_IMAGES": "<MAX_IMAGES>",
        "DEFAULT_TIMEOUT_MS": "<DEFAULT_TIMEOUT_MS>",
        "MIN_TIMEOUT_MS": "<MIN_TIMEOUT_MS>",
        "MAX_TIMEOUT_MS": "<MAX_TIMEOUT_MS>",
        "DEFAULT_DOCUMENT_CHARS": "<DEFAULT_DOCUMENT_CHARS>",
        "MAX_DOCUMENT_CHARS": "<MAX_DOCUMENT_CHARS>",
        "PROXY_SCHEME": "<PROXY_SCHEME>",
        "PROXY_HOST": "<PROXY_HOST>",
        "PROXY_PORT": "<PROXY_PORT>",
        "PROXY_LOGIN": "<PROXY_LOGIN>",
        "PROXY_PASSWORD": "<PROXY_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp-retrieval": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/role1776/mcp-retrieval:0.1.10"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "MCP_NAME": "<MCP_NAME>",
        "MCP_PATH": "<MCP_PATH>",
        "SERVER_PORT": "<SERVER_PORT>",
        "SERVER_READ_TIMEOUT": "<SERVER_READ_TIMEOUT>",
        "SERVER_WRITE_TIMEOUT": "<SERVER_WRITE_TIMEOUT>",
        "LOG_MODE": "<LOG_MODE>",
        "MAX_IDLE_CONNS_PER_HOST": "<MAX_IDLE_CONNS_PER_HOST>",
        "MAX_QUERIES": "<MAX_QUERIES>",
        "DEFAULT_RESULTS": "<DEFAULT_RESULTS>",
        "MAX_RESULTS": "<MAX_RESULTS>",
        "DEFAULT_IMAGES": "<DEFAULT_IMAGES>",
        "MAX_IMAGES": "<MAX_IMAGES>",
        "DEFAULT_TIMEOUT_MS": "<DEFAULT_TIMEOUT_MS>",
        "MIN_TIMEOUT_MS": "<MIN_TIMEOUT_MS>",
        "MAX_TIMEOUT_MS": "<MAX_TIMEOUT_MS>",
        "DEFAULT_DOCUMENT_CHARS": "<DEFAULT_DOCUMENT_CHARS>",
        "MAX_DOCUMENT_CHARS": "<MAX_DOCUMENT_CHARS>",
        "PROXY_SCHEME": "<PROXY_SCHEME>",
        "PROXY_HOST": "<PROXY_HOST>",
        "PROXY_PORT": "<PROXY_PORT>",
        "PROXY_LOGIN": "<PROXY_LOGIN>",
        "PROXY_PASSWORD": "<PROXY_PASSWORD>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

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

Details

Package	`ghcr.io/role1776/mcp-retrieval:0.1.10` (OCI, stdio)
Package	`https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/[email protected]` (MCPB, stdio)
Package	`https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/[email protected]` (MCPB, stdio)
Package	`https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/[email protected]` (MCPB, stdio)
Package	`https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/[email protected]` (MCPB, stdio)
Package	`https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/[email protected]` (MCPB, stdio)
Package	`https://github.com/Role1776/mcp-retrieval/releases/download/v0.1.10/[email protected]` (MCPB, stdio)
First published	24 Oct 2026
Last updated	24 Oct 2026
Registry name	`io.github.Role1776/mcp-retrieval`

More search and web servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use MCP Retrieval often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-role1776-mcp-retrieval/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-role1776-mcp-retrieval)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.