[!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
📄 License
Apache License 2.0
[!NOTE]
This project is licensed under the Apache License 2.0 – see the LICENSE file for details.
