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-mpc-server" ] } } } # local { "mcpServers": { "duckduckgo-search": { "command": "node", "args": [ "/path/to/duckduckgo-search/build/index.js" ] } } }