DuckDuckGo MCP Server

DuckDuckGo 검색 MCP 서버

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

특징

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

설치

Smithery를 통해 설치

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

지엑스피1

uv 를 통해 설치

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

용법

Claude Desktop으로 실행

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

다음 구성을 추가합니다.

3. Claude Desktop을 다시 시작하세요

개발

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

사용 가능한 도구

1. 검색 도구

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

매개변수:

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

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

2. 콘텐츠 가져오기 도구

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

매개변수:

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

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

자세한 기능

속도 제한

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

결과 처리

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

오류 처리

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

기여하다

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

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

특허

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