Ddg Search

DuckDuckGo, IAsk AI, Monica & Brave AI Search MCP 🔍🧠

Lightning-fast, privacy-first Model Context Protocol (MCP) server for web search and AI-powered answers. Powered by DuckDuckGo, IAsk AI, Monica, and Brave AI.

Subscribe for updates & tutorials

---

> [!IMPORTANT] > DuckDuckGo Search MCP supports the Model Context Protocol (MCP) standard, making it compatible with various AI assistants and tools.

---

✨ Features

🌐 Web search using DuckDuckGo HTML 🧠 AI search using IAsk AI, Monica & Brave AI ⚡ Performance optimized with caching 🛡️ Security features including rate limiting and rotating user agents 🔌 MCP-compliant server implementation 🆓 No API keys required - works out of the box

> [!IMPORTANT] > Unlike many search tools, this package performs actual web scraping rather than using limited APIs, giving you more comprehensive results.

---

🚀 Quick Start

Run instantly with npx:

npx -y @oevortex/ddg_search@latest

> [!TIP] > This will download and run the latest version of the MCP server directly without installation – perfect for quick use with AI assistants.

---

🛠️ Installation Options

Global Installation (npm)

npm install -g @oevortex/ddg_search

Run globally:

ddg-search-mcp

Global Installation (Yarn)

yarn global add @oevortex/ddg_search

Run globally:

ddg-search-mcp

Global Installation (pnpm)

pnpm add -g @oevortex/ddg_search

Run globally:

ddg-search-mcp

Local Installation (Development)

git clone https://github.com/OEvortex/ddg_search.git
cd ddg_search
npm install
npm start

Or with Yarn:

yarn install
yarn start

Or with pnpm:

pnpm install
pnpm start

---

🧑‍💻 Command Line Options

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

> [!TIP] > Use the --version flag to check which version you're running.

---

🤖 Using with MCP Clients

> [!IMPORTANT] > The most common way to use this tool is by integrating it with MCP-compatible AI assistants.

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "ddg-search": {
      "command": "npx",
      "args": ["-y", "@oevortex/ddg_search@latest"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "ddg-search": {
      "command": "ddg-search-mcp"
    }
  }
}

> [!TIP] > After configuring, restart your MCP client to apply the changes.

---

🧰 Tools Overview

🔍 Web Search Tool web-search

query (string, required): The search query page (integer, optional, default: 1): Page number numResults (integer, optional, default: 10): Number of results (1-20)

Example: Search the web for "climate change solutions"

🧠 IAsk AI Search Tool iask-search

query (string, required): The search query or question mode (string, optional, default: "question"): Search mode - "question", "academic", "forums", "wiki", or "thinking" detailLevel (string, optional): Response detail level - "concise", "detailed", or "comprehensive"

Example: Search IAsk AI for "Explain quantum computing in simple terms"

🤖 Monica AI Search Tool monica-search

query (string, required): The search query or question

Example: Search Monica AI for "Latest advancements in AI"

---

📁 Project Structure

bin/              # Command-line interface
src/
  index.js        # Main entry point
  tools/          # Tool definitions and handlers
    searchTool.js
    iaskTool.js
    monicaTool.js
  utils/
    search.js     # Search and URL utilities
    user_agents.js
    search_monica.js
    search_iask.js # IAsk AI search utilities
package.json
README.md

---

🤝 Contributing

Contributions are welcome! Please open issues or submit pull requests.

> [!NOTE] > Please follow the existing code style and add tests for new features.

---

📺 YouTube Channel

youtube.com/@OEvortex

---

📄 License

Apache License 2.0

> [!NOTE] > This project is licensed under the Apache License 2.0 – see the LICENSE file for details.

---

Made with ❤️ by @OEvortex

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: OEvortex
• Source: OEvortex/ddg_search
• License: Apache-2.0
• Homepage: https://www.npmjs.com/package/@oevortex/ddg_search

Install and usage instructions live in the source repository linked above.