search-web

DuckDuckGo▌

by zhsama

Integrate DuckDuckGo web search into your site with our MCP server, supporting features like Google custom search and ro

Experience fast and reliable DuckDuckGo web search with this TypeScript MCP server. It offers a simple search interface supporting customizable queries, result counts, and safe search levels. Built-in rate limiting ensures fair usage with up to 1 request per second and 15,000 per month. The server returns well-formatted Markdown results, making it easy to integrate and display search data. Designed to demonstrate core Model Context Protocol concepts, it also includes helpful debugging tools to inspect communication. Perfect for developers wanting seamless DuckDuckGo integration via MCP with efficient error handling and robust controls.

github stars

★ 70

GitHub npm

No API key requiredPrivacy-focused search engineMultiple deployment options (UVX, Docker)

best for

/ Research and fact-checking tasks
/ Getting current events and news updates
/ General web information retrieval
/ Privacy-focused web searches

capabilities

/ Search the web using DuckDuckGo
/ Retrieve real-time information from the internet
/ Format search results for easy consumption
/ Control number of results returned

what it does

Provides web search capabilities through DuckDuckGo's search engine. Returns formatted search results for any query without requiring API keys or authentication.

about

DuckDuckGo is a community-built MCP server published by zhsama that provides AI assistants with tools and capabilities via the Model Context Protocol. Integrate DuckDuckGo web search into your site with our MCP server, supporting features like Google custom search and ro It is categorized under search web. This server exposes 1 tool that AI clients can invoke during conversations and coding sessions.

how to install

You can install DuckDuckGo in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport. This server supports remote connections over HTTP, so no local installation is required.

license

MIT

DuckDuckGo is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

duckduckgo-search MCP Server

English | 中文

A Model Context Protocol server for DuckDuckGo Search

This is a TypeScript-based MCP server that provides DuckDuckGo search functionality. It demonstrates core MCP concepts through:

Integration with DuckDuckGo Search
Easy-to-use search tool interface
Rate limiting and error handling support

Features

Search Tool

duckduckgo_search - Perform web searches using DuckDuckGo API
- Required parameter: query (search query, max 400 characters)
- Optional parameter: count (number of results, 1-20, default 10)
- Optional parameter: safeSearch (safety level: strict/moderate/off, default moderate)
- Returns formatted Markdown search results

Rate Limits

Maximum 1 request per second
Maximum 15000 requests per month

Development

Prerequisites

Node.js >= 18
pnpm >= 8.0.0

Installation

# Install pnpm if not already installed
npm install -g pnpm

# Install project dependencies
pnpm install

Build and Run

Build the server:

pnpm run build

For development with auto-rebuild:

pnpm run watch

Setup in Claude Desktop

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

# local
{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "node",
      "args": [
        "/path/to/duckduckgo-search/build/index.js"
      ]
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

pnpm run inspector

The Inspector will provide a URL to access debugging tools in your browser.