Skip to main content
Glama
nacho4d

mcp-web-search

by nacho4d
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-web-search

A local MCP server providing DuckDuckGo web search and site fetching tools for Claude Desktop.

Tools

Tool

Description

search_list

Search DuckDuckGo and return up to 10 ranked results

access_site

Fetch a URL (follows redirects) and return its text content

Related MCP server: DuckDuckGo MCP Server

Setup

0. uv

if uv seems not to be available try this absolute path.

$HOME/.local/bin/uv

1. Install dependencies

uv sync

2. Test the server starts

uv run mcp-web-search
# Pass transport (optional) and host (optional) and port(optional) to start with streamable http protocol
uv run mcp-web-search --transport streamable-http --host 127.0.0.1 --port 8000

You should see the server waiting on stdin — that means it's working. Press Ctrl+C to stop.

Connect to Claude Desktop

Add the following to your Claude Desktop config file.

Config file location:

OS

Path

macOS

$HOME/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "web-search": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/absolute/path/to/mcp-web-search",
        "mcp-web-search"
      ]
    }
  }
}

Replace /absolute/path/to/mcp-web-search with the actual path to this folder.

Restart Claude Desktop — both tools will appear in the 🔌 menu.

Tool Reference

search_list

Input: { "query": "DocLang document specification" }

Output:

{
  "success": true,
  "query": "DocLang document specification",
  "results_count": 10,
  "results": [
    {
      "rank": 1,
      "title": "...",
      "url": "https://...",
      "snippet": "..."
    }
  ]
}

access_site

Input: { "url": "https://doclang.org" }

Output:

{
  "success": true,
  "requested_url": "https://doclang.org",
  "final_url": "https://doclang.org/",
  "status_code": 200,
  "content_type": "text/html; charset=utf-8",
  "truncated": false,
  "content": "Page text content..."
}

Troubleshooting

Problem

Fix

ModuleNotFoundError

Run uv sync to install dependencies

Tools don't appear in Claude

Use an absolute path in the config; restart Claude Desktop

DDGSException: Ratelimit

DuckDuckGo rate-limited you; wait a moment and retry

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nacho4d/mcp-web-search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server