MCP DuckDuckGo Search Server

by spences10

2 stars

1 downloads

Not rated

GitHub

About

Enables integration with DuckDuckGo search capabilities for LLMs, supporting comprehensive web search, regional filtering, result types, and safe browsing with caching and customizable search parameters.

Details

Author: spences10
Repository: spences10/mcp-duckduckgo-search
GitHub stars: 2
Downloads: 1
License: MIT License
Categories: Search, AI

- 🔍 Comprehensive web search using DuckDuckGo's search engine
- 📊 Rich result types including:
- Knowledge graph information
- Organic search results
- News articles
- Video content
- Image results
- Related searches
- 🌍 Region-specific search support
- 🛡️ Configurable safe search levels
- 📅 Date-based filtering options
- 📄 Pagination support
- 💾 Built-in result caching
- 🔒 Safe search options (off, moderate, strict)

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name MCP DuckDuckGo Search Server

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 mcp-duckduckgo-search
Environment
- SERPAPI_KEY your-serpapi-api-key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {},
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
            ],
            "command": "wsl.exe"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

From the repository

This server requires configuration through your MCP client. Here are
examples for different environments:

Add this to your Cline MCP settings:

{
	"mcpServers": {
		"mcp-duckduckgo-search": {
			"command": "npx",
			"args": ["-y", "mcp-duckduckgo-search"],
			"env": {
				"SERPAPI_KEY": "your-serpapi-api-key"
			}
		}
	}
}

For WSL environments, add this to your Claude Desktop configuration:

{
	"mcpServers": {
		"mcp-duckduckgo-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
			]
		}
	}
}

The server requires the following environment variable:

- SERPAPI_KEY: Your SerpAPI key (required)

`ddg_search`

Perform web searches using the DuckDuckGo search engine. Parameters: query (string, required), region (string, optional), safe_search (string, optional), date_filter (string, optional), start (number, optional), no_cache (boolean, optional)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp duckduckgo search server": {
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            },
            "args": [
                "-y",
                "mcp-duckduckgo-search"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "SERPAPI_KEY": "your-serpapi-api-key"
    },
    "args": [
        "-y",
        "mcp-duckduckgo-search"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "SERPAPI_KEY": "your-serpapi-api-key"
    },
    "args": [
        "-y",
        "mcp-duckduckgo-search"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "bash",
        "-c",
        "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
    ],
    "command": "wsl.exe"
}

mcp-duckduckgo-search

---

⚠️ Notice

This repository is no longer maintained.

The functionality of this tool is now available in mcp-omnisearch, which combines multiple MCP tools in one unified package.

Please use mcp-omnisearch instead.

---

A Model Context Protocol (MCP) server for integrating DuckDuckGo
search capabilities with LLMs. This server provides comprehensive web
search functionality with support for various result types and
filtering options.

Features

Configuration

This server requires configuration through your MCP client. Here are
examples for different environments:

Cline Configuration

Add this to your Cline MCP settings:

{
	"mcpServers": {
		"mcp-duckduckgo-search": {
			"command": "npx",
			"args": ["-y", "mcp-duckduckgo-search"],
			"env": {
				"SERPAPI_KEY": "your-serpapi-api-key"
			}
		}
	}
}

Claude Desktop with WSL Configuration

For WSL environments, add this to your Claude Desktop configuration:

{
	"mcpServers": {
		"mcp-duckduckgo-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
			]
		}
	}
}

Environment Variables

The server requires the following environment variable:

- SERPAPI_KEY: Your SerpAPI key (required)

API

The server implements a single MCP tool with configurable parameters:

ddg_search

Perform web searches using the DuckDuckGo search engine.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

ddg_search

Claude Desktop / Cursor

Linux

Macos

Windows

mcp-duckduckgo-search

⚠️ Notice

Features

Configuration

Cline Configuration

Claude Desktop with WSL Configuration

Environment Variables

API

ddg_search

Install

More like this

Brave Search

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

`ddg_search`