OEvortex/ddg_search
If you are the rightful owner of ddg_search and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
DuckDuckGo & Felo AI Search MCP is a privacy-friendly Model Context Protocol server for web search and AI-powered responses using DuckDuckGo and Felo AI.
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.
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 file for details.
