Repolode
nickclyde

nickclyde/duckduckgo-mcp-server

AI 어시스턴트에 DuckDuckGo 웹 검색과 웹페이지 콘텐츠 가져오기 및 파싱 기능을 제공하는 MCP 서버입니다.

스타
1,550
포크
195
열린 이슈
7
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Claude Desktop 및 Claude Code 같은 AI 어시스턴트가 DuckDuckGo 웹 검색을 수행하고 웹페이지의 콘텐츠를 읽을 수 있도록 하는 Model Context Protocol (MCP) 서버입니다. 제목, URL, 스니펫을 반환하는 검색 도구와 페이지를 다운로드해 읽을 수 있는 텍스트를 추출하는 fetch_content 도구를 제공합니다. 긴 페이지는 페이지네이션으로 나눠 가져올 수 있습니다.

언어 모델에 최신 웹 정보를 간결한 형태로 제공하는 것이 목적입니다. 검색 결과의 긴 URL은 짧은 ref:// 토큰으로 바뀌며, 이 토큰을 fetch_content에 전달하거나 필요할 때 원래 URL로 확장할 수 있어 컨텍스트를 절약합니다. 콘텐츠 가져오기는 text, main-content, markdown 추출 모드를 지원하며, 기본 httpx 클라이언트를 차단하는 사이트에 사용할 수 있는 선택형 브라우저 사칭 백엔드(curl_cffi)도 제공합니다.

운영자는 환경 변수나 CLI 플래그로 SafeSearch 수준, 기본 지역, 요청 속도 제한, 메모리 내 페이지 캐시를 설정할 수 있습니다. 기본적으로 fetch_content는 비공개 및 루프백 주소로의 요청을 차단하며, stdio, SSE, streamable HTTP 전송 방식을 지원합니다.

핵심 기능

  • 01SafeSearch 수준과 기본 지역을 설정해 DuckDuckGo에서 검색합니다.
  • 02웹페이지를 가져와 start_index 페이지네이션으로 읽을 수 있는 텍스트를 추출합니다.
  • 03text, main-content, markdown 파싱 모드를 제공합니다.
  • 04긴 URL을 짧은 ref:// 토큰으로 바꿔 컨텍스트를 절약합니다.
  • 05요청 속도 제한, TTL 페이지 캐시, HTTP 429 재시도 처리를 제공합니다.
  • 06일반 HTTP 클라이언트를 차단하는 사이트를 위한 선택형 curl_cffi 백엔드를 지원합니다.
  • 07기본적으로 fetch_content에서 비공개 및 루프백 주소로의 요청을 차단합니다.

활용 사례

  • Claude Desktop이나 Claude Code에 실시간 웹 검색 결과를 제공하는 경우.
  • 검색으로 찾은 기사나 문서 페이지의 텍스트를 AI 에이전트가 읽도록 하는 경우.
  • 프라이빗 네트워크 내 다른 MCP 클라이언트에 HTTP로 검색 및 콘텐츠 가져오기 서비스를 제공하는 경우.

빠른 시작

  1. 1

    uvx로 서버 실행

    uvx duckduckgo-mcp-server
  2. 2

    또는 uv를 사용해 PyPI에서 설치

    uv pip install duckduckgo-mcp-server

사용 전 알아둘 점

  • DuckDuckGo가 기본 httpx 클라이언트를 차단하면 검색 결과가 비어 있을 수 있으므로, 선택 사항인 [browser] extra를 사용하는 것이 좋습니다.

포함된 컬렉션

토픽

자주 묻는 질문

duckduckgo-mcp-server은(는) 무엇인가요?
AI 어시스턴트에 DuckDuckGo 웹 검색과 웹페이지 콘텐츠 가져오기 및 파싱 기능을 제공하는 MCP 서버입니다. Claude Desktop 및 Claude Code 같은 AI 어시스턴트가 DuckDuckGo 웹 검색을 수행하고 웹페이지의 콘텐츠를 읽을 수 있도록 하는 Model Context Protocol (MCP) 서버입니다. 제목, URL, 스니펫을 반환하는 검색 도구와 페이지를 다운로드해 읽을 수 있는 텍스트를 추출하는 fetch_content 도구를 제공합니다. 긴 페이지는 페이지네이션으로 나눠 가져올 수 있습니다.
duckduckgo-mcp-server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
duckduckgo-mcp-server은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
duckduckgo-mcp-server은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. duckduckgo-mcp-server의 마지막 커밋은 2026년 9월 4일입니다.
duckduckgo-mcp-server은(는) 어디에 사용할 수 있나요?
Claude Desktop이나 Claude Code에 실시간 웹 검색 결과를 제공하는 경우. 검색으로 찾은 기사나 문서 페이지의 텍스트를 AI 에이전트가 읽도록 하는 경우. 프라이빗 네트워크 내 다른 MCP 클라이언트에 HTTP로 검색 및 콘텐츠 가져오기 서비스를 제공하는 경우.
duckduckgo-mcp-server는 어떻게 설치하나요?
uvx로 서버 실행: uvx duckduckgo-mcp-server 또는 uv를 사용해 PyPI에서 설치: uv pip install duckduckgo-mcp-server
duckduckgo-mcp-server은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nickclyde/duckduckgo-mcp-server

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트