ddgs-mcp-server 0.4.0

DuckDuckGo Search MCP Server

DDGS MCP Server

A Model Context Protocol (MCP) server that provides DuckDuckGo Search capabilities to AI agents.

Features

• search_text: advanced metasearch using bing, brave, duckduckgo, google, mojeek, yahoo, yandex, wikipedia.
• search_news: Find latest updates, releases, and tech news.

Installation & Usage

You can run this server directly using uvx without installing it globally.

VS Code (Claude Desktop / Cline)

Add this to your MCP settings file (e.g., cline_mcp_settings.json or claude_desktop_config.json):

{
  "mcpServers": {
    "ddgs-search": {
      "command": "uvx",
      "args": [
        "ddgs-mcp-server"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Manual Execution

uvx ddgs-mcp-server

Secrets & Configuration

This project technically does not require API keys to run locally, as it scrapes DuckDuckGo. However, for publishing or proxy usage, you should configure your environment.

1. Set up Secrets

Copy the example file:

cp .env.example .env

2. Required Tokens

Token	Purpose	How to Get It
PyPI API Token	Publishing to PyPI	1. Go to PyPI Account Settings 2. Select "Add API Token" 3. Scope to "Entire account" (for first publish) 4. Set as TWINE_PASSWORD in .env
Proxy URL	Bypassing Blocks (Optional)	Use any HTTP/SOCKS5 proxy provider if you encounter rate limits.

Development / Publishing

To build and publish this package to PyPI (using the secrets from above):

1. Build:

   pip install build twine
   python -m build
   

2. Publish (loads secrets from .env if you export them, or prompts you):

   # If using .env variables (PowerShell)
   # $env:TWINE_USERNAME = "__token__"
   # $env:TWINE_PASSWORD = "pypi-..."
   
   python -m twine upload dist/*