DuckDuckGo Search MCP 🔍
A blazing-fast, privacy-friendly Model Context Protocol (MCP) server for web search and URL content extraction using DuckDuckGo.
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
[!TIP] This will download and run the MCP server directly without installation – perfect for quick use with AI assistants.
🛠️ Installation Options
Global Installation
npm install -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
🧑💻 Command Line Options
npx -y @oevortex/ddg_search --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"]
}
}
}
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)
fetch-url- url (string, required): The URL to fetch
- maxLength (integer, optional, default: 10000): Max content length
- extractMainContent (boolean, optional, default: true): Extract main content
- includeLinks (boolean, optional, default: true): Include link text
- includeImages (boolean, optional, default: true): Include image alt text
- excludeTags (array, optional): Tags to exclude
url-metadata- url (string, required): The URL to extract metadata from
📁 Project Structure
bin/ # Command-line interface
src/
index.js # Main entry point
tools/ # Tool definitions and handlers
searchTool.js
fetchUrlTool.js
metadataTool.js
utils/
search.js # Search and URL 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
youtube.com/@OEvortex
📄 License
Apache License 2.0
[!NOTE] This project is licensed under the Apache License 2.0 – see the LICENSE file for details.
DuckDuckGo Search MCP
Project Details
- OEvortex/ddg_search
- Other
- Last Updated: 4/16/2025
Recomended MCP Servers
A MCP Server implementation for interacting with Unreal Engine instances through remote Python execution.
A MCP server to query and generate answers based on the ATproto documentation available online
A macOS AppleScript MCP server
"primitive" RAG-like web search model context protocol (MCP) server that runs locally. ✨ no APIs ✨
A collection of tools for your LLMs that run on Modal
Model Context Protocol (MCP) Server for reading from Google Drive and editing Google Sheets
A Model Context Protocol (MCP) server that bridges Video & Audio content with Large Language Models using yt-dlp.
OpenAPI MCP Server
Featured Templates
View More
