home / mcp / ddg mcp server

DDG MCP Server

A powerful Model Context Protocol (MCP) server for web search and URL content extraction using DuckDuckGo.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "oevortex-ddg_search": {
      "command": "ddg-search-mcp",
      "args": [],
      "env": {
        "YourEnvVarPlaceholder": "EXAMPLE_VALUE"
      }
    }
  }
}

You run a fast, privacy-first MCP server that combines DuckDuckGo web search with AI-powered results from IAsk AI, Monica, and Brave AI. It’s designed to work out of the box, integrate with MCP clients, and deliver search capabilities without relying on external APIs that require keys.

How to use

You connect this MCP server to your MCP client to perform web searches and retrieve AI-assisted answers. Use it to power search actions in your assistants, answer questions with up-to-date results, and keep interactions fast with built-in caching and security features.

How to install

Prerequisites: ensure you have a supported runtime installed on your system. You should have Node.js available for the standard MCP server workflow.

# Quick start with npx (no installation required)
npx -y @oevortex/ddg_search@latest

If you prefer a traditional installation, you can install globally or run locally for development. Choose one of the following options.

# Global installation with npm
npm install -g @oevortex/ddg_search
# Run globally
ddg-search-mcp
```
```bash
# Global installation with Yarn
yarn global add @oevortex/ddg_search
# Run globally
ddg-search-mcp
```
```bash
# Global installation with pnpm
pnpm add -g @oevortex/ddg_search
# Run globally
ddg-search-mcp

For local development, clone the project, install dependencies, and start the server locally.

git clone https://github.com/OEvortex/ddg_search.git
cd ddg_search
npm install
npm start
```
```bash
# Or with Yarn
yarn install
yarn start
```
```bash
# Or with pnpm
pnpm install
pnpm start

Additional notes for setup and usage

You can verify usage by running the help command to see available options and version information.

npx -y @oevortex/ddg_search@latest --help

Available tools

web-search

Web Search Tool retrieves results by querying DuckDuckGo HTML pages with parameters for query, page, and numResults.

iask-search

IAsk AI Search Tool queries IAsk AI with modes like question, academic, forums, wiki, or thinking and supports detail levels.

monica-search

Monica AI Search Tool queries Monica AI for concise results on user questions.

brave-search

Brave AI Search Tool queries Brave AI with an optional deep research mode enabled by enableResearch.