MCP Retrieval MCP Server

io.github.Role1776/mcp-retrieval

Repository Registry

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.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "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)

Active

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

MIT

View repository →

io.github.RoleModel/optics-mcp

Maintained

MCP Server for Optics Design System documentation and token usage.

TypeScript

MIT

View repository →

io.github.RollingGo-AI/hotelbooking

Active

AI-powered hotel search, comparison, and booking for agents and MCP clients—free, unlimited calls, 2M+ hotels worldwide.

Python

MIT

View repository →

io.github.RollingGo-AI/hotelbooking-ai

Active

Search and book 2M+ hotels globally with real-time pricing and inventory via AI agents.

Python

MIT

View repository →

Mails.ai — Agent Email

A real inbox for AI agents: send, receive and thread email, behind a prompt-injection firewall.

Upspring

Maintained

Live ads as reasoning-ready context, plus advertiser spend/traffic/sales scale grades over MCP.

MIT

View repository →