Provides comprehensive search capabilities through DuckDuckGo including text search, image search, video search, news search, and book search with support for advanced search operators and filtering options
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 (рекомендуется) uv pip install -r requirements.txt # Или с pip pip install -r requirements.txtПримечание:
Запуск
Сервер может работать в двух режимах: 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
: Максимальное количество результатов - по умолчанию 10page
: Номер страницы результатов - по умолчанию 1backend
: Поисковые движки (auto, google, bing, и т.д.) - по умолчанию "auto"
search_images
Поиск изображений через DDGS
Параметры:
query
(обязательный): Поисковый запросregion
: Регион - по умолчанию "us-en"safesearch
: Уровень фильтрации (on, moderate, off) - по умолчанию "moderate"timelimit
: Ограничение по времени (d, w, m, y)max_results
: Максимальное количество результатов - по умолчанию 10page
: Номер страницы результатов - по умолчанию 1backend
: Поисковые движки - по умолчанию "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
: Максимальное количество результатов - по умолчанию 10page
: Номер страницы результатов - по умолчанию 1backend
: Поисковые движки - по умолчанию "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
: Максимальное количество результатов - по умолчанию 10page
: Номер страницы результатов - по умолчанию 1backend
: Поисковые движки - по умолчанию "auto"
search_books
Поиск книг через DDGS
Параметры:
query
(обязательный): Поисковый запросmax_results
: Максимальное количество результатов - по умолчанию 10page
: Номер страницы результатов - по умолчанию 1backend
: Поисковые движки - по умолчанию "auto"
Примеры использования
Текстовый поиск
Поиск изображений
Получение операторов поиска
Операторы поиска DDG
cats dogs
- Результаты о cats или dogs"cats and dogs"
- Результаты точного совпадения "cats and dogs"cats -dogs
- Меньше упоминаний dogs в результатахcats +dogs
- Больше упоминаний dogs в результатахcats filetype:pdf
- PDF файлы о catsdogs site:example.com
- Страницы о dogs с сайта example.comcats -site:example.com
- Страницы о cats, исключая example.comintitle:dogs
- Заголовок страницы содержит слово "dogs"inurl:cats
- URL страницы содержит слово "cats"
Примеры конфигов
Для TCP
Jan:
Для Jan и Cline не рекомендую использовать TCP
Конфигурация для запуска напрямую
Конфигурация с использованием Python из venv (рекомендуется)
Замените
Обработка ошибок
Сервер может возвращать следующие ошибки:
Превышение лимита запросов
Таймаут запроса
Общие ошибки поиска
Тестирование
Проект включает несколько тестовых скриптов для проверки работы сервера в разных режимах:
Для запуска введите:
и следуйте инструкциям.
Поддержка прокси
Для использования прокси можно установить переменную окружения DDGS_PROXY
:
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 managementOr standard
pip
andvenv
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/activateNote: If you use
Install dependencies:
# With uv (recommended) uv pip install -r requirements.txt # Or with pip pip install -r requirements.txtNote:
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.pyBy 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 initializationtools/list
- Get list of available toolstools/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 queryregion
: 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 10page
: Result page number - default 1backend
: Search engines (auto, google, bing, etc.) - default "auto"
search_images
Image search via DDGS
Parameters:
query
(required): Search queryregion
: 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 10page
: Result page number - default 1backend
: 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 queryregion
: 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 10page
: Result page number - default 1backend
: 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 queryregion
: 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 10page
: Result page number - default 1backend
: Search engines - default "auto"
search_books
Book search via DDGS
Parameters:
query
(required): Search querymax_results
: Maximum number of results - default 10page
: Result page number - default 1backend
: Search engines - default "auto"
Usage Examples
Text Search
Image Search
Getting Search Operators
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 resultscats +dogs
- More mentions of dogs in resultscats filetype:pdf
- PDF files about catsdogs site:example.com
- Pages about dogs from example.comcats -site:example.com
- Pages about cats, excluding example.comintitle:dogs
- Page title contains the word "dogs"inurl:cats
- Page URL contains the word "cats"
Configuration Examples
For TCP
Jan:
TCP mode is not recommended for Jan and Cline
Configuration for Direct Launch
Configuration Using Python from venv (Recommended)
Replace
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:
and follow the instructions.
Proxy Support
To use a proxy, you can set the DDGS_PROXY
environment variable:
This server cannot be installed
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
- AsecurityAlicenseAqualityEnables 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 -128The Unlicense
- -securityAlicense-qualityEnables 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 -303MIT License
- -securityAlicense-qualityProvides 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 -6MIT License
- AsecurityFlicenseAqualityA server that provides DuckDuckGo search capabilities (text, image, news, video search and AI chat) through the Model Context Protocol.Last updated -59