@oevortex/ddg_search NPM

!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

npm install -g @oevortex/ddg_search

Run globally:

ddg-search-mcp

git clone https://github.com/OEvortex/ddg_search.git
cd ddg_search
npm install
npm 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

📁 Project Structure

bin/              # Command-line interface
src/
  index.js        # Main entry point
  tools/          # Tool definitions and handlers
    searchTool.js
    fetchUrlTool.js
    metadataTool.js
    feloTool.js
  utils/
    search.js     # Search and URL utilities
    search_felo.js # Felo AI search utilities
package.json
README.md