DuckDuckGo Search MCP
A privacy-friendly MCP server that enables web searches and URL content extraction using DuckDuckGo, allowing AI assistants to access real-time web information without API keys.
README Documentation
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
[!IMPORTANT] Unlike many search tools, this package performs actual web scraping rather than using limited APIs, giving you more comprehensive results.
🚀 Quick Start
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
--versionflag 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- query (string, required): The search query
- page (integer, optional, default: 1): Page number
- numResults (integer, optional, default: 10): Number of results (1-20)
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"
monica-search- query (string, required): The search query or question
📁 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.