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.
Important
Unlike many search tools, this package performs actual web scraping rather than using limited APIs, giving you more comprehensive results.
npx -y @oevortex/ddg_search@latestTip
This will download and run the latest version of the MCP server directly without installation – perfect for quick use with AI assistants.
Global Installation (npm)
npm install -g @oevortex/ddg_searchRun globally:
ddg-search-mcpGlobal Installation (Yarn)
yarn global add @oevortex/ddg_searchRun globally:
ddg-search-mcpGlobal Installation (pnpm)
pnpm add -g @oevortex/ddg_searchRun globally:
ddg-search-mcpLocal Installation (Development)
git clone https://github.com/OEvortex/ddg_search.git
cd ddg_search
npm install
npm startOr with Yarn:
yarn install
yarn startOr with pnpm:
pnpm install
pnpm startnpx -y @oevortex/ddg_search@latest --helpTip
Use the --version flag to check which version you're running.
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.
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
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
Contributions are welcome! Please open issues or submit pull requests.
Note
Please follow the existing code style and add tests for new features.
Apache License 2.0
Note
This project is licensed under the Apache License 2.0 – see the LICENSE file for details.