PluginBench
MCP Server
Active
MIT

MCP Retrieval MCP Server

io.github.Role1776/mcp-retrieval

RepositoryRegistry
How to choose

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.

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
JSON config
{
  "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

XTX (Twitter) logo

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

2
Go
MIT
View repository →

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

0
JavaScript
MIT
View repository →

Beta: OpenAlex literature search and local evidence retrieval. External acceptance test pending.

0
Python
MIT
View repository →

BYOK Reddit/YouTube research CLI with a tamper-evident audit log and an MCP server.

0
Python
Apache-2.0
View repository →

MCP Server for Optics Design System documentation and token usage.

0
TypeScript
MIT
View repository →

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

39
Python
MIT
View repository →