PluginBench
MCP Server
Active
MIT

MCP Retrieval MCP Server

io.github.Role1776/mcp-retrieval

RepositoryRegistry

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.

Claude Desktop
~/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>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.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>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "mcp-retrieval": {
      "type": "stdio",
      "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>"
      }
    }
  }
}
Claude Code
claude mcp add mcp-retrieval --env MCP_TRANSPORT=<YOUR_MCP_TRANSPORT> --env MCP_NAME=<YOUR_MCP_NAME> --env MCP_PATH=<YOUR_MCP_PATH> --env SERVER_PORT=<YOUR_SERVER_PORT> --env SERVER_READ_TIMEOUT=<YOUR_SERVER_READ_TIMEOUT> --env SERVER_WRITE_TIMEOUT=<YOUR_SERVER_WRITE_TIMEOUT> --env LOG_MODE=<YOUR_LOG_MODE> --env MAX_IDLE_CONNS_PER_HOST=<YOUR_MAX_IDLE_CONNS_PER_HOST> --env MAX_QUERIES=<YOUR_MAX_QUERIES> --env DEFAULT_RESULTS=<YOUR_DEFAULT_RESULTS> --env MAX_RESULTS=<YOUR_MAX_RESULTS> --env DEFAULT_IMAGES=<YOUR_DEFAULT_IMAGES> --env MAX_IMAGES=<YOUR_MAX_IMAGES> --env DEFAULT_TIMEOUT_MS=<YOUR_DEFAULT_TIMEOUT_MS> --env MIN_TIMEOUT_MS=<YOUR_MIN_TIMEOUT_MS> --env MAX_TIMEOUT_MS=<YOUR_MAX_TIMEOUT_MS> --env DEFAULT_DOCUMENT_CHARS=<YOUR_DEFAULT_DOCUMENT_CHARS> --env MAX_DOCUMENT_CHARS=<YOUR_MAX_DOCUMENT_CHARS> --env PROXY_SCHEME=<YOUR_PROXY_SCHEME> --env PROXY_HOST=<YOUR_PROXY_HOST> --env PROXY_PORT=<YOUR_PROXY_PORT> --env PROXY_LOGIN=<YOUR_PROXY_LOGIN> --env PROXY_PASSWORD=<YOUR_PROXY_PASSWORD> -- docker run -i --rm ghcr.io/role1776/mcp-retrieval:0.1.7

Related MCP servers

com.browser-use/browser-use

Active

Control a real Chrome browser to complete any task: fill forms, extract data, book flights.

110k
Python
MIT
View repository →

World Monitor

Active

Real-time global intelligence: markets, conflicts, country risk, energy, and infrastructure monitoring via 39 MCP tools.

83k
TypeScript
AGPL-3.0
View repository →

Netdata

Active

Real-time infrastructure monitoring with per-second metrics, ML-powered anomaly detection, and zero-configuration setup.

80k
Go
GPL-3.0
View repository →

io.github.IncorporatedPartners/labelhead-artist-momentum

Active

Trending hip-hop artist momentum scores across four cultural dimensions.

79k
TypeScript
MIT
View repository →

io.github.ruvnet/claude-flow

Active

AI orchestration platform with 100+ agents, swarm coordination, and self-learning memory for enterprise development.

68k
TypeScript
MIT
View repository →

Scrapling MCP Server

Active

Web scraping with stealth HTTP, real browsers, and Cloudflare bypass capabilities.

67k
Python
BSD-3-Clause
View repository →