DuckDuckGo를 통해 웹 검색 기능을 제공하며, 콘텐츠 가져오기 및 파싱을 위한 추가 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

퀵 스타트

특징

• 웹 검색: 고급 속도 제한과 결과 서식을 적용한 DuckDuckGo 검색
• 콘텐츠 가져오기: 지능형 텍스트 추출을 이용한 웹페이지 콘텐츠 검색 및 파싱
• 긴 URL 단축: 너무 긴 결과 URL은 ref://가 직접 받아 컨텍스트를 절약하는 짧은 ref:// 토큰이 됩니다.
• 속도 제한: 검색 및 콘텐츠 가져오기 모두에 대한 속도 제한에 대한 내장 보호
• 오류 처리: 포괄적인 오류 처리 및 로깅
• LLM 친화적 출력: 대규모 언어 모델 소비를 위해 특별히 포맷된 결과들

설치

uv를 사용하여 PyPI에서 설치하기:

사용

클로드 데스크톱으로 달리기

1. Claude 데스크톱 다운로드
2. Claude Desktop 설정을 생성하거나 편집하기:

• 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.