Сервер Model Context Protocol (MCP), предоставляющий возможности веб-поиска через DuckDuckGo, с дополнительными функциями для извлечения и парсинга контента.

Быстрый старт

Особенности

• Веб-поиск: Поиск в DuckDuckGo с расширенным ограничением скорости и форматированием результатов
• Получение контента: Получение и разбор содержимого веб-страницы с помощью интеллектуального извлечения текста
• Укорочение длинных URL: Слишком длинные URL-адреса результатов становятся короткими ref:// токенами, которые fetch_content принимает напрямую, сохраняя контекст
• Ограничение скорости: встроенная защита от ограничений скорости как для поиска, так и для получения контента
• Обработка ошибок: Комплексная обработка ошибок и логирование
• LLM-дружественный вывод: результаты, отформатированные специально для потребления больших языковых моделей

Установка

Установка из PyPI с помощью uv:

Использование

Запуск с Claude Desktop

1. Скачать Claude Desktop
2. Создайте или отредактируйте конфигурацию вашего рабочего стола Claude:

• На macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• На окнах: %APPDATA%\Claude\claude_desktop_config.json

Добавьте следующую конфигурацию:

Базовая конфигурация (без безопасного поиска, без региона по умолчанию):

DuckDuckGo Search MCP Server

A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.

Quick Start

uvx duckduckgo-mcp-server

Features

• Web Search: Search DuckDuckGo with advanced rate limiting and result formatting
• Content Fetching: Retrieve and parse webpage content with intelligent text extraction
• Long URL Shortening: Over-long result URLs become short ref:// tokens that fetch_content accepts directly, saving context
• Rate Limiting: Built-in protection against rate limits for both search and content fetching
• Error Handling: Comprehensive error handling and logging
• LLM-Friendly Output: Results formatted specifically for large language model consumption

Installation

Install from PyPI using uv:

uv pip install duckduckgo-mcp-server

Usage

Running with Claude Desktop

1. Download Claude Desktop
2. Create or edit your Claude Desktop configuration:
   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

Basic Configuration (No SafeSearch, No Default Region):

{
    "mcpServers": {
        "ddg-search": {
            "command": "uvx",
            "args": ["duckduckgo-mcp-server"]
        }
    }
}

With SafeSearch and Region Configuration:

{
    "mcpServers": {
        "ddg-search": {
            "command": "uvx",
            "args": ["duckduckgo-mcp-server"],
            "env": {
                "DDG_SAFE_SEARCH": "STRICT",
                "DDG_REGION": "cn-zh"
            }
        }
    }
}

Configuration Options:

• DDG_SAFE_SEARCH: SafeSearch filtering level (optional)
  • STRICT: Maximum content filtering (kp=1)
  • MODERATE: Balanced filtering (kp=-1, default if not specified)
  • OFF: No content filtering (kp=-2)
• DDG_REGION: Default region/language code (optional, examples below)
  • us-en: United States (English)
  • cn-zh: China (Chinese)
  • jp-ja: Japan (Japanese)
  • wt-wt: No specific region
  • Leave empty for DuckDuckGo’s default behavior
• DDG_CA_CERTS: Path to a PEM CA bundle used to verify TLS certificates on outbound requests (optional). Needed behind TLS-intercepting proxies — see Running behind a TLS-intercepting proxy.