DuckDuckGo MCP

왜 쓰나요

핵심 기능

API 키 없는 웹 검색
URL 콘텐츠 추출 (readability 방식)
내장 속도 제한 + 콘텐츠 길이 안전 제한
uvx로 즉시 설치
지역/언어 힌트 지원

라이브 데모

실제 사용 모습

duckduckgo-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

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

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "duckduckgo-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "duckduckgo-mcp-server"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add duckduckgo-mcp -- uvx duckduckgo-mcp-server

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: DuckDuckGo MCP

웹 증거로 주장 팩트 체크

👤 AI 환각을 경계하는 모든 분 ⏱ ~5 min beginner

언제 쓸까: 인용하기 전에 Claude가 통계나 인용문을 검증하길 원할 때.

흐름

검색

Use duckduckgo-mcp. Search for the original source of the claim 'Postgres 17 added unloggable replication slots'.✓ 복사됨

→ 관련 URL이 있는 결과 목록
상위 결과 읽기

Fetch the top 2 official-looking results and quote what they actually say.✓ 복사됨

→ URL이 있는 인용 발췌
판정

Is the claim accurate? If not, what's the closest true statement?✓ 복사됨

→ 인용이 있는 판정

결과: 감이 아닌 출처가 있는 주장.

함정

상위 결과가 실제 문서를 재구성한 컨텐츠 팜 — 공식 도메인 선호 (postgresql.org, github.com/<project>); 목록 형식 글 건너뜀

함께 쓰기: context7

도구 결정을 위한 세 가지 옵션 조사

👤 라이브러리를 평가하는 엔지니어 ⏱ ~20 min beginner

언제 쓸까: A/B/C 중에서 선택해야 하고 빠른 비교 스캔을 원할 때.

흐름

기준 정의

Criteria for comparing 3 ORMs: license, async support, last release, GitHub stars, known limitations.✓ 복사됨

→ 기준 확정
옵션별 검색

For each ORM, search for: official site, latest release notes, recent critical issue.✓ 복사됨

→ 옵션별 링크 묶음
비교 표

Build a comparison table from what the pages actually say. Cite sources.✓ 복사됨

→ 인용이 있는 표 형식 비교

결과: 브라우저 탭 30개 없이 결정 가능한 비교.

함정

오래된 정보 — 마지막 릴리스 날짜 틀림 — 서드파티 블로그가 아닌 공식 릴리스 페이지 또는 GitHub 릴리스 항상 확인

함께 쓰기: git-mcp-idosal

특정 URL 가져오기 및 요약

👤 Claude를 통해 기사를 읽는 모든 분 ⏱ ~3 min beginner

언제 쓸까: URL이 있는데 1500단어의 군더더기 대신 핵심과 주요 인용이 필요할 때.

흐름

페치

Use duckduckgo-mcp. Fetch <url> and return the cleaned content.✓ 복사됨

→ 내비게이션/광고 없는 읽기 가능한 텍스트
요약

TL;DR in 5 bullets + 3 direct quotes worth keeping.✓ 복사됨

→ 불릿 + 인용; 꾸며낸 내용 없음

결과: 기사를 30초 만에 파악.

함정

JavaScript 렌더링 페이지 — 페처가 아무것도 못 가져옴 — SPA 페이지에서는 브라우저 MCP (browser-tools, chrome-devtools-mcp)로 폴백

조합

다른 MCP와 조합해 10배 효율

duckduckgo-mcp + context7

2단계 문서 조회: 라이브러리는 Context7, 나머지는 DuckDuckGo

Try context7 first; if it doesn't have the library, fall back to duckduckgo-mcp.✓ 복사됨

duckduckgo-mcp + git-mcp-idosal

웹에서 프로젝트를 찾은 다음 저장소를 심층 탐색

Search 'fastest small embedding model 2026'. Pick top repo, switch to gitmcp for source.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
search	query: str, max_results?, region?	개방형 웹 조회	Throttled by DDG; treat as ~30 req/min/IP
fetch_content	url: str, max_length?	검색에서 1–3개의 유망한 URL을 선택한 후	Throttled by target site

비용 및 제한

운영 비용

API 쿼터: DDG는 공식 API가 아님 — IP당 비공식 제한 약 30회/분; 급증하면 차단될 수 있음
호출당 토큰: 검색 약 500–2000 token; fetch_content는 페이지에 따라 다름
금액: 무료
팁: 일반적인 조회는 로컬에 캐시; 매 대화 턴마다 검색하지 않기

보안

권한, 시크릿, 파급범위

최소 스코프: Outbound HTTPS only

자격 증명 저장: 없음 — 키 불필요

데이터 외부 송신: duckduckgo.com + 페치하는 사이트

검색 쿼리가 DDG로 전송됨 — 프로파일링은 안 하지만 로그는 함; 브라우저에서 검색하지 않을 내용은 검색하지 않기

문제 해결

자주 발생하는 오류와 해결

모든 검색이 빈 결과 반환

DDG가 연속적인 요청을 차단할 수 있음 — 잠시 대기; curl 'https://duckduckgo.com/?q=test'로 확인

확인: Try a manual browser query

페치가 대부분 내비게이션 쓰레기를 반환

일부 사이트는 실제 브라우저가 필요; 브라우저 MCP로 전환. 또는 max_length를 낮춰 후미 건너뜀

429 Too Many Requests

60초 대기; 동시성 줄이기; 서버에 내장 스로틀이 있지만 급증하는 에이전트 루프는 여전히 트리거될 수 있음

지역별 결과가 잘못됨

region 파라미터 전달 (us-en, jp-jp 등)

대안

DuckDuckGo MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Tavily MCP	신뢰할 수 있는 속도 제한이 있는 더 고품질의 에이전트 최적화 검색이 필요할 때	API 키 필요; 무료 티어 초과 시 유료
Exa MCP	LLM 소비에 최적화된 신경망 검색을 원할 때	유료; 가입 필요
Firecrawl MCP	임시 검색이 아닌 크롤링/스크래핑이 필요할 때	형태가 다름 — 쿼리별이 아닌 사이트 전체 작업