DuckDuckGo MCP: веб-поиск для агента без ключа и регистрации

nickclyde/duckduckgo-mcp-server· Проверено 12.11.2026· 1,6 тыс.на GitHub

Даёт агенту поиск DuckDuckGo без ключа API: найти страницы по запросу и прочитать текст найденной страницы. Подходит, когда платный поисковый API не нужен.

2 реализации:

Поиск плюс чтение страниц через fetch_content, лимиты запросов, кеш и обход блокировки по TLS-отпечатку; пакет на PyPI, запуск через uvx.

Как подключить

Что сделать до подключения

uv с командой uvx

Дополнение [browser] ставится тем же uvx --with: без него поиск может возвращать пустой ответ

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio duckduckgo \
  -- uvx --with 'duckduckgo-mcp-server[browser]' duckduckgo-mcp-server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.duckduckgo]
command = "uvx"
args = ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "duckduckgo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "duckduckgo": {
        "type": "local",
        "command": [
          "uvx",
          "--with",
          "duckduckgo-mcp-server[browser]",
          "duckduckgo-mcp-server"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["--with", "duckduckgo-mcp-server[browser]", "duckduckgo-mcp-server"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

searchищет в DuckDuckGo

fetch_contentчитает текст страницы

expand_linkраскрывает короткую ссылку ref://

Один инструмент поиска на TypeScript, запуск через npx; страницы не читает.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio duckduckgo-mcp-server \
  -- npx -y duckduckgo-mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.duckduckgo-mcp-server]
command = "npx"
args = ["-y", "duckduckgo-mcp-server"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "duckduckgo-mcp-server": {
        "type": "local",
        "command": ["npx", "-y", "duckduckgo-mcp-server"]
      }
    }
  }
}

{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Инструменты сервера

duckduckgo_searchищет в DuckDuckGo, до 20 результатов

Что попросить агента

«Найди в DuckDuckGo <тема> и дай 5 ссылок с кратким описанием»Агент вызовет search с max_results 5 и перескажет заголовки и сниппеты

«Найди обзор <тема> и перескажи главное из первой статьи»Агент вызовет search, затем fetch_content с parse_mode main по адресу или токену ref:// из результатов

«Поищи новости по <тема> в регионе de-de»Агент вызовет search с параметром region de-de

«Покажи полный адрес третьего результата»Агент раскроет токен ref:// через expand_link

Для каких задач

Найти свежие страницы по теме и показать заголовки, адреса и сниппеты

Прочитать найденную статью целиком или только основной текст в Markdown

Искать с фильтром SafeSearch и с привязкой к региону и языку

Дочитать длинную страницу частями без повторной загрузки

Ограничения

DuckDuckGo блокирует обычный клиент httpx по TLS-отпечатку и отвечает пустой страницей: для поиска нужен пакет с дополнением [browser]

По умолчанию не больше 30 поисков и 20 загрузок страниц в минуту

fetch_content по умолчанию не открывает локальные и внутренние адреса

duckduckgo-search MCP Server от zhsama: 87 звёзд, последнее обновление в апреле 2025 года, лимит 1 запрос в секунду и 15 000 в месяц

Если не работает

Поиск возвращает «no results» или пустой ответ

html.duckduckgo.com блокирует httpx по TLS-отпечатку. Поставьте дополнение [browser]: uvx --with "duckduckgo-mcp-server[browser]" duckduckgo-mcp-server.

Ошибки проверки сертификата за корпоративным прокси

Укажите CA-сертификат прокси флагом --ca-certs /path/to/proxy-ca.pem или переменной DDG_CA_CERTS.

За обратным прокси или в Docker запросы падают с 421 Misdirected Request

Разрешите нужные хосты флагами --allowed-hosts и --allowed-origins или переменными DDG_ALLOWED_HOSTS и DDG_ALLOWED_ORIGINS.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
DuckDuckGo Search MCP Server	nickclyde	1,6 тыс.	локально	не нужен	3	4 сентября 2026
duckduckgo-search MCP Server	zhsama	87	локально	не нужен	1	4 апреля 2025

Частые вопросы

Нужен ли ключ API?

Нет. Оба сервера ходят в DuckDuckGo без ключа и регистрации, в конфиге нет ни одной обязательной переменной.

Почему поиск ничего не находит?

html.duckduckgo.com отвечает пустой страницей с кодом 202 клиенту httpx. У nickclyde поиск по умолчанию переключается на curl с отпечатком Chrome, но только если стоит дополнение [browser]: запускайте uvx --with "duckduckgo-mcp-server[browser]" duckduckgo-mcp-server.

Как задать регион и безопасный поиск?

У nickclyde через переменные DDG_REGION (например us-en, de-de, wt-wt) и DDG_SAFE_SEARCH: STRICT, MODERATE или OFF. Регион агент может поменять в отдельном запросе, SafeSearch задаётся только при запуске.

Можно ли запустить сервер по HTTP для нескольких клиентов?

Да, у nickclyde есть флаги --transport sse и --transport streamable-http; адрес по умолчанию 127.0.0.1:8000, меняется флагами --host и --port.

Как подключить DuckDuckGo MCP к Claude Code?

Выполните claude mcp add ddg-search uvx duckduckgo-mcp-server, нужен uvx. Чтобы поиск не упирался в блокировку, добавьте дополнение [browser]: команда с --with есть во вкладке Claude Code в блоке «Как подключить».

Чем DuckDuckGo MCP отличается от Brave Search MCP?

DuckDuckGo MCP работает без ключа API и регистрации, зато ограничен лимитами по умолчанию: 30 поисков в минуту у nickclyde и 1 запрос в секунду у zhsama.

Работает ли сервер из России?

Серверы работают на вашем компьютере без ключей и аккаунтов; запросы уходят напрямую на сайт DuckDuckGo.

DuckDuckGo MCP: веб-поиск для агента без ключа и регистрации

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы