DuckDuckGo Search MCP Server

MCP сервер для поиска информации через DuckDuckGo Search

Этот MCP сервер предоставляет инструменты для поиска информации в интернете с использованием библиотеки DDGS (DuckDuckGo Search).

Установка

Требования

Python 3.8+
uv (https://github.com/astral-sh/uv) - рекомендуется для управления зависимостями
Или стандартный pip и venv

Шаги установки

Клонируйте репозиторий или создайте папку проекта:
mkdir duck_duck_MCP cd duck_duck_MCP
(Рекомендуется) Создайте виртуальное окружение:
# С uv uv venv # Активируйте (Windows) venv\Scripts\activate # Активируйте (Linux/macOS) source .venv/bin/activate
Примечание: Если вы используете uv, он автоматически создаст и активирует .venv при первом запуске uv pip install.
Установите зависимости:
# С uv (рекомендуется) uv pip install -r requirements.txt # Или с pip pip install -r requirements.txt
Примечание: ddgs - это библиотека для работы с DuckDuckGo Search.

Запуск

Сервер может работать в двух режимах: STDIO и TCP.

Режим STDIO

Этот режим используется для прямого взаимодействия через стандартные потоки ввода/вывода. Подходит для запуска из терминала или интеграции с клиентами, которые запускают сервер как дочерний процесс.

Запустите сервер напрямую:
# Если вы в виртуальном окружении python ddg_mcp_server.py # Или с полным путем к python из venv venv\Scripts\python.exe ddg_mcp_server.py

Режим TCP

Этот режим запускает сервер как TCP-сервер, прослушивающий указанный порт. Подходит для интеграции с клиентами, которые подключаются по сети.

Запустите TCP-сервер:
# Если вы в виртуальном окружении python tcp_ddg_server.py # Или с полным путем к python из venv venv\Scripts\python.exe tcp_ddg_server.py
По умолчанию сервер запустится на 127.0.0.1:8765. Вы увидите сообщение:
TCP сервер запущен на 127.0.0.1:8765

Поддерживаемые методы MCP

Сервер реализует следующие методы протокола MCP:

initialize - Инициализация сервера
tools/list - Получение списка доступных инструментов
tools/call - Вызов инструмента

Доступные инструменты

`get_search_operators`

Получить документацию по операторам поиска DDG

Параметры: нет

`search_text`

Текстовый поиск через DDGS

Параметры:

query (обязательный): Поисковый запрос
region: Регион (us-en, uk-en, ru-ru, и т.д.) - по умолчанию "us-en"
safesearch: Уровень фильтрации (on, moderate, off) - по умолчанию "moderate"
timelimit: Ограничение по времени (d, w, m, y)
max_results: Максимальное количество результатов - по умолчанию 10
page: Номер страницы результатов - по умолчанию 1
backend: Поисковые движки (auto, google, bing, и т.д.) - по умолчанию "auto"

`search_images`

Поиск изображений через DDGS

Параметры:

query (обязательный): Поисковый запрос
region: Регион - по умолчанию "us-en"
safesearch: Уровень фильтрации (on, moderate, off) - по умолчанию "moderate"
timelimit: Ограничение по времени (d, w, m, y)
max_results: Максимальное количество результатов - по умолчанию 10
page: Номер страницы результатов - по умолчанию 1
backend: Поисковые движки - по умолчанию "auto"
size: Размер изображения (Small, Medium, Large, Wallpaper)
color: Цвет изображения (color, Monochrome, Red, и т.д.)
type_image: Тип изображения (photo, clipart, gif, и т.д.)
layout: Макет изображения (Square, Tall, Wide)
license_image: Лицензия изображения (any, Public, Share, и т.д.)

`search_videos`

Поиск видео через DDGS

Параметры:

query (обязательный): Поисковый запрос
region: Регион - по умолчанию "us-en"
safesearch: Уровень фильтрации (on, moderate, off) - по умолчанию "moderate"
timelimit: Ограничение по времени (d, w, m)
max_results: Максимальное количество результатов - по умолчанию 10
page: Номер страницы результатов - по умолчанию 1
backend: Поисковые движки - по умолчанию "auto"
resolution: Разрешение видео (high, standard)
duration: Длительность видео (short, medium, long)
license_videos: Лицензия видео (creativeCommon, youtube)

`search_news`

Поиск новостей через DDGS

Параметры:

query (обязательный): Поисковый запрос
region: Регион - по умолчанию "us-en"
safesearch: Уровень фильтрации (on, moderate, off) - по умолчанию "moderate"
timelimit: Ограничение по времени (d, w, m)
max_results: Максимальное количество результатов - по умолчанию 10
page: Номер страницы результатов - по умолчанию 1
backend: Поисковые движки - по умолчанию "auto"

`search_books`

Поиск книг через DDGS

Параметры:

query (обязательный): Поисковый запрос
max_results: Максимальное количество результатов - по умолчанию 10
page: Номер страницы результатов - по умолчанию 1
backend: Поисковые движки - по умолчанию "auto"

Примеры использования

Текстовый поиск

{
  "method": "search_text",
  "params": {
    "query": "python programming",
    "max_results": 5,
    "region": "us-en"
  }
}

Поиск изображений

{
  "method": "search_images",
  "params": {
    "query": "cats",
    "max_results": 10,
    "color": "Monochrome"
  }
}

Получение операторов поиска

{
  "method": "get_search_operators",
  "params": {}
}

Операторы поиска DDG

cats dogs - Результаты о cats или dogs
"cats and dogs" - Результаты точного совпадения "cats and dogs"
cats -dogs - Меньше упоминаний dogs в результатах
cats +dogs - Больше упоминаний dogs в результатах
cats filetype:pdf - PDF файлы о cats
dogs site:example.com - Страницы о dogs с сайта example.com
cats -site:example.com - Страницы о cats, исключая example.com
intitle:dogs - Заголовок страницы содержит слово "dogs"
inurl:cats - URL страницы содержит слово "cats"

Примеры конфигов

Для TCP

{
  "mcpServers": {
    "ddg-tcp": {
      "timeout": 120,
      "command": "tcp",
      "args": [
        "127.0.0.1:8765"
      ],
      "env": {},
      "active": true
    }
  }
} 

Jan:

{
  "command": "tcp",
  "args": [
    "127.0.0.1:8765"
  ],
  "env": {},
  "active": true
}

Для Jan и Cline не рекомендую использовать TCP

Конфигурация для запуска напрямую

{
  "mcpServers": {
    "ddg-stdio": {
      "disabled": true,
      "timeout": 60,
      "type": "stdio",
      "command": "python",
      "args": [
        "Path_To\\ddg_mcp_server.py"
      ],
      "env": {}
    }
  }
}

Конфигурация с использованием Python из venv (рекомендуется)

{
  "mcpServers": {
    "ddg-stdio": {
      "command": "Полный_путь_к_папке_duck_duck_MCP\\venv\\Scripts\\python.exe",
      "timeout": 120,
       "type": "stdio",
      "args": [
        "Полный_путь_к_папке_duck_duck_MCP\\ddg_mcp_server.py"
      ],
      "env": {},
      "active": true
    }
  }
}

Замените Полный_путь_к_папке_duck_duck_MCP на реальный путь к вашему проекту. Например: E:\\Users\\Igory\\Desktop\\duck_duck_MCP\\venv\\Scripts\\python.exe

Обработка ошибок

Сервер может возвращать следующие ошибки:

Превышение лимита запросов
Таймаут запроса
Общие ошибки поиска

Тестирование

Проект включает несколько тестовых скриптов для проверки работы сервера в разных режимах:

Для запуска введите:

python test_server_enhanced.py

и следуйте инструкциям.

Поддержка прокси

Для использования прокси можно установить переменную окружения DDGS_PROXY:

export DDGS_PROXY="socks5h://user:password@1.2.3.4:8080"

MCP Server for Information Search via DuckDuckGo Search

This MCP server provides tools for searching information on the internet using the DDGS (DuckDuckGo Search) library.

Installation

Requirements

Python 3.8+
uv (https://github.com/astral-sh/uv) - recommended for dependency management
Or standard pip and venv

Installation Steps

Clone the repository or create a project folder:
mkdir duck_duck_MCP cd duck_duck_MCP
(Recommended) Create a virtual environment:
# With uv uv venv # Activate (Windows) venv\Scripts\activate # Activate (Linux/macOS) source .venv/bin/activate
Note: If you use uv, it will automatically create and activate .venv when you first run uv pip install.
Install dependencies:
# With uv (recommended) uv pip install -r requirements.txt # Or with pip pip install -r requirements.txt
Note: ddgs is a library for working with DuckDuckGo Search.

Running

The server can work in two modes: STDIO and TCP.

STDIO Mode

This mode is used for direct interaction through standard input/output streams. Suitable for running from the terminal or integration with clients that launch the server as a child process.

Run the server directly:
# If you're in a virtual environment python ddg_mcp_server.py # Or with full path to python from venv venv\Scripts\python.exe ddg_mcp_server.py

TCP Mode

This mode launches the server as a TCP server listening on the specified port. Suitable for integration with clients that connect over the network.

Run TCP server:
# If you're in a virtual environment python tcp_ddg_server.py # Or with full path to python from venv venv\Scripts\python.exe tcp_ddg_server.py
By default, the server will start on 127.0.0.1:8765. You will see the message:
TCP server started on 127.0.0.1:8765

Supported MCP Methods

The server implements the following MCP protocol methods:

initialize - Server initialization
tools/list - Get list of available tools
tools/call - Call tool

Available Tools

`get_search_operators`

Get documentation on DDG search operators

Parameters: none

`search_text`

Text search via DDGS

Parameters:

query (required): Search query
region: Region (us-en, uk-en, ru-ru, etc.) - default "us-en"
safesearch: Filtering level (on, moderate, off) - default "moderate"
timelimit: Time limit (d, w, m, y)
max_results: Maximum number of results - default 10
page: Result page number - default 1
backend: Search engines (auto, google, bing, etc.) - default "auto"

`search_images`

Image search via DDGS

Parameters:

query (required): Search query
region: Region - default "us-en"
safesearch: Filtering level (on, moderate, off) - default "moderate"
timelimit: Time limit (d, w, m, y)
max_results: Maximum number of results - default 10
page: Result page number - default 1
backend: Search engines - default "auto"
size: Image size (Small, Medium, Large, Wallpaper)
color: Image color (color, Monochrome, Red, etc.)
type_image: Image type (photo, clipart, gif, etc.)
layout: Image layout (Square, Tall, Wide)
license_image: Image license (any, Public, Share, etc.)

`search_videos`

Video search via DDGS

Parameters:

query (required): Search query
region: Region - default "us-en"
safesearch: Filtering level (on, moderate, off) - default "moderate"
timelimit: Time limit (d, w, m)
max_results: Maximum number of results - default 10
page: Result page number - default 1
backend: Search engines - default "auto"
resolution: Video resolution (high, standard)
duration: Video duration (short, medium, long)
license_videos: Video license (creativeCommon, youtube)

`search_news`

News search via DDGS

Parameters:

query (required): Search query
region: Region - default "us-en"
safesearch: Filtering level (on, moderate, off) - default "moderate"
timelimit: Time limit (d, w, m)
max_results: Maximum number of results - default 10
page: Result page number - default 1
backend: Search engines - default "auto"

`search_books`

Book search via DDGS

Parameters:

query (required): Search query
max_results: Maximum number of results - default 10
page: Result page number - default 1
backend: Search engines - default "auto"

Usage Examples

Text Search

{
  "method": "search_text",
  "params": {
    "query": "python programming",
    "max_results": 5,
    "region": "us-en"
  }
}

Image Search

{
  "method": "search_images",
  "params": {
    "query": "cats",
    "max_results": 10,
    "color": "Monochrome"
  }
}

Getting Search Operators

{
  "method": "get_search_operators",
  "params": {}
}

DDG Search Operators

cats dogs - Results about cats or dogs
"cats and dogs" - Exact match results for "cats and dogs"
cats -dogs - Fewer mentions of dogs in results
cats +dogs - More mentions of dogs in results
cats filetype:pdf - PDF files about cats
dogs site:example.com - Pages about dogs from example.com
cats -site:example.com - Pages about cats, excluding example.com
intitle:dogs - Page title contains the word "dogs"
inurl:cats - Page URL contains the word "cats"

Configuration Examples

For TCP

{
  "mcpServers": {
    "ddg-tcp": {
      "timeout": 120,
      "command": "tcp",
       "type": "tcp",
      "args": [
        "127.0.0.1:8765"
      ],
      "env": {},
      "active": true
    }
  }
}

Jan:

{
  "command": "tcp",
  "args": [
    "127.0.0.1:8765"
  ],
  "env": {},
  "active": true
}

TCP mode is not recommended for Jan and Cline

Configuration for Direct Launch

{
  "mcpServers": {
    "ddg-stdio": {
      "command": "python",
      "timeout": 120,
       "type": "stdio",
      "args": [
        "Path_to_duck_duck_MCP_folder\\ddg_mcp_server.py"
      ],
      "env": {},
      "active": true
    }
  }
}

Configuration Using Python from venv (Recommended)

{
  "mcpServers": {
    "ddg-stdio": {
      "command": "Full_path_to_duck_duck_MCP_folder\\venv\\Scripts\\python.exe",
      "timeout": 120,
       "type": "stdio",
      "args": [
        "Full_path_to_duck_duck_MCP_folder\\ddg_mcp_server.py"
      ],
      "env": {},
      "active": true
    }
  }
}

Replace Full_path_to_duck_duck_MCP_folder with the actual path to your project. For example: E:\\Users\\Igory\\Desktop\\duck_duck_MCP\\venv\\Scripts\\python.exe

Error Handling

The server may return the following errors:

Request limit exceeded
Request timeout
General search errors

Testing

The project includes several test scripts to check server operation in different modes:

To run, enter:

python test_server_enhanced.py

and follow the instructions.

Proxy Support

To use a proxy, you can set the DDGS_PROXY environment variable:

export DDGS_PROXY="socks5h://user:password@1.2.3.4:8080"

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables comprehensive internet search capabilities through DuckDuckGo, supporting text, images, videos, news, and books search with advanced filtering options and search operators.

Related MCP Servers

Google Custom Search Engine MCP Server
Richard-Weiss
A
security
A
license
A
quality
Enables search capabilities using a Google Custom Search Engine, allowing users to input a search term and retrieve search result titles, links, and snippets, while facilitating integration with other tools for content extraction and advanced search strategies.
Last updated -
1
28
The Unlicense
MCP DuckDuckGo Search Server
spences10
-
security
A
license
-
quality
Enables integration with DuckDuckGo search capabilities for LLMs, supporting comprehensive web search, regional filtering, result types, and safe browsing with caching and customizable search parameters.
Last updated -
26
3
MIT License
MCP DuckDuckGo Search Plugin
gianlucamazza
-
security
A
license
-
quality
Provides web search functionality via DuckDuckGo for Claude Code and MCP-compatible clients, featuring advanced content exploration, navigation across search results, and detailed webpage analysis.
Last updated -
5
MIT License
DuckDuckGo MCP Server
misanthropic-ai
A
security
F
license
A
quality
A server that provides DuckDuckGo search capabilities (text, image, news, video search and AI chat) through the Model Context Protocol.
Last updated -
5
8

View all related MCP servers

MCP сервер для поиска информации через DuckDuckGo Search

Установка

Требования

Шаги установки

Запуск

Режим STDIO

Режим TCP

Поддерживаемые методы MCP

Доступные инструменты

get_search_operators

search_text

search_images

search_videos

search_news

search_books

Примеры использования

Текстовый поиск

Поиск изображений

Получение операторов поиска

Операторы поиска DDG

Примеры конфигов

Для TCP

Конфигурация для запуска напрямую

Конфигурация с использованием Python из venv (рекомендуется)

Обработка ошибок

Тестирование

Для запуска введите:

Поддержка прокси

MCP Server for Information Search via DuckDuckGo Search

Installation

Requirements

Installation Steps

Running

STDIO Mode

TCP Mode

Supported MCP Methods

Available Tools

get_search_operators

search_text

search_images

search_videos

search_news

search_books

Usage Examples

Text Search

Image Search

Getting Search Operators

DDG Search Operators

Configuration Examples

For TCP

Configuration for Direct Launch

Configuration Using Python from venv (Recommended)

Error Handling

Testing

To run, enter:

Proxy Support

Related MCP Servers

Google Custom Search Engine MCP Server

MCP DuckDuckGo Search Server

MCP DuckDuckGo Search Plugin

DuckDuckGo MCP Server

New MCP Servers

MCP directory API

`get_search_operators`

`search_text`

`search_images`

`search_videos`

`search_news`

`search_books`

`get_search_operators`

`search_text`

`search_images`

`search_videos`

`search_news`

`search_books`