DuckDuckGo MCP Server

by nickclyde
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides web search capabilities through DuckDuckGo's search engine, including features for searching the web, retrieving and parsing webpage content, with rate limiting and result formatting optimized for large language model consumption.

DuckDuckGo 검색 MCP 서버

DuckDuckGo를 통해 웹 검색 기능을 제공하고, 콘텐츠 페칭 및 구문 분석을 위한 추가 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

  • 웹 검색 : 고급 속도 제한 및 결과 서식을 사용하여 DuckDuckGo 검색
  • 콘텐츠 가져오기 : 지능형 텍스트 추출을 통해 웹 페이지 콘텐츠를 검색하고 구문 분석합니다.
  • 속도 제한 : 검색 및 콘텐츠 페칭 모두에 대한 속도 제한에 대한 내장형 보호 기능
  • 오류 처리 : 포괄적인 오류 처리 및 로깅
  • LLM 친화적 출력 : 대규모 언어 모델 소비를 위해 특별히 포맷된 결과

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 DuckDuckGo 검색 서버를 자동으로 설치하는 방법:

지엑스피1

uv 를 통해 설치

uv 사용하여 PyPI에서 직접 설치:

uv pip install duckduckgo-mcp-server

용법

Claude Desktop으로 실행

  1. Claude Desktop 다운로드
  2. Claude Desktop 구성을 생성하거나 편집하세요.
    • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

다음 구성을 추가합니다.

{ "mcpServers": { "ddg-search": { "command": "uvx", "args": ["duckduckgo-mcp-server"] } } }
  1. Claude Desktop을 다시 시작하세요

개발

로컬 개발을 위해 MCP CLI를 사용할 수 있습니다.

# Run with the MCP Inspector mcp dev server.py # Install locally for testing with Claude Desktop mcp install server.py

사용 가능한 도구

1. 검색 도구

async def search(query: str, max_results: int = 10) -> str

DuckDuckGo에서 웹 검색을 수행하여 서식이 지정된 결과를 반환합니다.

매개변수:

  • query : 검색 쿼리 문자열
  • max_results : 반환할 최대 결과 수(기본값: 10)

반환값: 제목, URL, 스니펫이 포함된 검색 결과가 포함된 형식화된 문자열입니다.

2. 콘텐츠 가져오기 도구

async def fetch_content(url: str) -> str

웹페이지에서 콘텐츠를 가져와서 구문 분석합니다.

매개변수:

  • url : 콘텐츠를 가져올 웹 페이지 URL

반환: 웹페이지의 텍스트 콘텐츠를 정리하고 형식을 지정했습니다.

자세한 기능

속도 제한

  • 검색: 분당 30개 요청으로 제한됨
  • 콘텐츠 가져오기: 분당 20개 요청으로 제한됨
  • 자동 대기 관리 및 대기 시간

결과 처리

  • 광고 및 관련 없는 콘텐츠를 제거합니다.
  • DuckDuckGo 리디렉션 URL을 정리합니다.
  • 최적의 LLM 소비를 위한 결과 형식
  • 긴 내용을 적절하게 잘라냅니다.

오류 처리

  • 포괄적인 오류 포착 및 보고
  • MCP 컨텍스트를 통한 자세한 로깅
  • 속도 제한 또는 시간 초과에 대한 우아한 저하

기여하다

이슈 및 풀 리퀘스트는 환영합니다! 개선이 필요한 부분은 다음과 같습니다.

  • 추가 검색 매개변수(지역, 언어 등)
  • 향상된 콘텐츠 구문 분석 옵션
  • 자주 액세스되는 콘텐츠에 대한 캐싱 계층
  • 추가 속도 제한 전략

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

DuckDuckGo를 통해 웹 검색 기능을 제공하고, 콘텐츠 페칭 및 구문 분석을 위한 추가 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Installing via uv
    2. Usage
      1. Running with Claude Desktop
      2. Development
    3. Available Tools
      1. 1. Search Tool
      2. 2. Content Fetching Tool
    4. Features in Detail
      1. Rate Limiting
      2. Result Processing
      3. Error Handling
    5. Contributing
      1. License
        ID: phcus2gcpn