mcphub.in
Loading languages...
@O

@oevortex/ddg_search

@OEvortex10

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

web search
duckduckgo
url extraction
mcp server
npm version License: Apache 2.0 YouTube Channel

DuckDuckGo, IAsk AI & Monica Search MCP 🔍🧠

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

DuckDuckGo Search MCP server
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
⚡ 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

📄 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

# mcpServer Config 

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

# stdio 

npx -y @oevortex/ddg_search@latest
view tools online
Transport:
stdio
Language:
JavaScript
Created: 4/15/2025
Updated: 8/5/2025
Homepage:
https://www.npmjs.com/package/@oevortex/ddg_search

Recommend MCP Servers 💡

MCP-server-Deepseek_R1

MCP-server-Deepseek_R1

66julienmartin

An MCP server connecting Claude Desktop with DeepSeek's R1/V3 language models for enhanced reasoning capabilities.

2025-02-05
JavaScript
mcp-reddit-companion

mcp-reddit-companion

saginawj

An MCP tool enabling natural language interaction with personal Reddit experience, allowing analysis and engagement with custom curated feeds via LLM clients.

2025-04-19
Python
hexitex/MCP-Backup-Server

hexitex/MCP-Backup-Server

hexitex

A specialized MCP server providing backup and restoration capabilities for AI agents and code editing tools, tested in Cursor and Windsurf editors.

2025-03-10
JavaScript
builtwith

builtwith

builtwith

A Model Context Protocol (MCP) server that integrates with BuiltWith's technology detection API, allowing AI assistants to identify the technology stack behind any website through natural language commands.

2025-05-05
JavaScript
3loka/consul-mcp-server

3loka/consul-mcp-server

3loka

A Model Control Protocol (MCP) server for interacting with HashiCorp Consul service discovery and service mesh, enabling Claude to analyze microservices architecture, create diagrams, identify issues, and provide recommendations through natural language.

2025-04-21
TypeScript
mcp-link

mcp-link

automation-ai-labs

A tool that automatically converts any OpenAPI V3 API into an MCP Server, enabling seamless integration with AI agents.

2025-03-29
sse