Mcp Web Tools

Name: Mcp Web Tools
Author: deadraid

Local

github.com/deadraidSearch2Updated 35w ago

Repository

About Mcp Web Tools

Mcp Web Tools is an MCP server that gives AI applications web search and page-fetching tools. It uses DuckDuckGo for searches and extracts content from specified URLs.

Key features

01Search the web with DuckDuckGo
02Fetch and extract page content
03Set result count and search region
04Filter searches by time
05Choose whether to include links or images

Use cases

01Find web sources for a query
02Retrieve content from a specific page
03Limit results by region or time
04Extract page text with optional links

MCP support

Exposes `web_search` and `web_page` tools to MCP clients for DuckDuckGo searches and web-page retrieval and extraction.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "web-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-search-server"
      ]
    }
  }
}

Run commandnpx -y mcp-search-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmmcp-search-serverstdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Search Tools

MCP Server for web search and page access tools

MCP (Model Context Protocol) server providing internet access tools. This server is categorized under "internet" and "web" to indicate its capability for online connectivity.

Overview

This package provides MCP-compatible tools for internet operations:

web_search: Search the web using DuckDuckGo (requires internet access)
web_page: Fetch and extract content from web pages (requires internet access)

🚀 Quick Start

Universal MCP Configuration

All modern AI editors use the same MCP configuration format:

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "mcp-search-server"]
    }
  }
}

Editor Configuration Locations

Editor	Configuration File
Claude Desktop	`claude_desktop_config.json`
Cursor	Settings > MCP > Add Server
Claude Code	`.claude.json` in project root
Windsurf	`.windsurfrc` in project root
Cline	`.cline/mcp.json` in project root
Zed	Settings > Extensions > MCP

📋 Available Tools

web_search

Search the web using DuckDuckGo.

Parameters:

query (string): Search query to execute
maxResults (number, optional): Maximum number of results (default: 10)
region (string, optional): Region for search results (default: 'wt-wt')
time (string, optional): Time filter ('d', 'w', 'm', 'y')
maxRetries (number, optional): Maximum retry attempts (default: 3)
retryDelay (number, optional): Base delay in milliseconds (default: 1000)

web_page

Fetch and extract content from a web page.

Parameters:

url (string): URL of the web page to fetch
maxLength (number, optional): Maximum content length (default: 8000)
includeImages (boolean, optional): Include images in response (default: false)
includeLinks (boolean, optional): Include links in response (default: true)
maxRetries (number, optional): Maximum retry attempts (default: 3)
retryDelay (number, optional): Base delay in milliseconds (default: 1000)

🔧 Development

# Clone repository
git clone https://github.com/deadraid/mcp-web-tools.git
cd mcp-web-tools

# Install dependencies
npm install

# Build
npm run build

# Run server
npm run start:server

📁 Examples

See the examples/ directory for configuration files for different editors:

examples/claude-desktop-config.json
examples/cursor-config.json
examples/claude-code-config.json

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.