mcp-web

A simple MCP server that search on DuckDuckGo

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tsfreddie-mcp-web": {
      "command": "npx",
      "args": [
        "-y",
        "@tsfreddie/mcp-web"
      ]
    }
  }
}

You can use the mcp-web server to perform web searches via DuckDuckGo and fetch content from URLs, with human-assisted CAPTCHA handling when needed. This MCP server is intended to be run on your machine in stdio mode through an MCP client, giving you a controllable and human-centric browsing workflow.

How to use

To utilize this server, configure your MCP client to spawn the MCP package using the stdio flow. This server handles web search and URL fetching, with CAPTCHA challenges requiring human input. In your client, load the MCP configuration snippet below to begin.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Create or update your MCP client configuration to include the mcp-web server as a stdio endpoint. The exact command you run from your client will depend on how your MCP client launches stdio servers, but the essential details are shown in the snippet.

{
  "mcpServers": {
    "web": {
      "command": "npx",
      "args": ["-y", "@tsfreddie/mcp-web"]
    }
  }
}

Additional notes

This server sends requests to https://html.duckduckgo.com and supports navigating server-rendered articles. It does not bypass CAPTCHA protections; a human may need to solve CAPTCHAs when encountered.

Usage is focused on local, client-driven operation via stdio mode. Do not expect full automation or server-wide background operation; the design emphasizes human initiation and intervention when required.

License: MIT. This MCP server is designed to be run on your machine with your MCP client and is intended for interactive use.

Examples and tips

Use the provided configuration snippet in your MCP client to begin a session that can perform searches and fetch results.
When you encounter CAPTCHA prompts, complete them manually to continue the browsing session.