MCP DuckDuckGo Search Server

by spences10
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

  • Allows web search functionality using the DuckDuckGo search engine, providing knowledge graph information, organic search results, news articles, video content, image results, and related searches with support for region-specific search, safe search levels, and date-based filtering

mcp-duckduckgo-search


⚠️ 공지사항

이 저장소는 더 이상 유지되지 않습니다.

이 도구의 기능은 이제 여러 MCP 도구를 하나의 통합 패키지로 결합한 mcp-omnisearch 에서 사용할 수 있습니다.

대신 mcp-omnisearch를 사용하세요.


DuckDuckGo 검색 기능을 LLM과 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 다양한 결과 유형과 필터링 옵션을 지원하는 포괄적인 웹 검색 기능을 제공합니다.

특징

  • 🔍 DuckDuckGo 검색 엔진을 활용한 포괄적인 웹 검색
  • 📊 다음을 포함한 풍부한 결과 유형:
    • 지식 그래프 정보
    • 유기적 검색 결과
    • 뉴스 기사
    • 비디오 콘텐츠
    • 이미지 결과
    • 관련 검색
  • 🌍 지역별 검색 지원
  • 🛡️ 구성 가능한 안전 검색 수준
  • 📅 날짜 기반 필터링 옵션
  • 📄 페이지 매김 지원
  • 💾 내장된 결과 캐싱
  • 🔒 안전 검색 옵션(끄기, 보통, 엄격)

구성

이 서버를 사용하려면 MCP 클라이언트를 통한 구성이 필요합니다. 다음은 다양한 환경에 대한 예시입니다.

클라인 구성

Cline MCP 설정에 다음을 추가하세요.

지엑스피1

WSL 구성을 사용한 Claude Desktop

WSL 환경의 경우 Claude Desktop 구성에 다음을 추가하세요.

{ "mcpServers": { "mcp-duckduckgo-search": { "command": "wsl.exe", "args": [ "bash", "-c", "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search" ] } } }

환경 변수

서버에는 다음 환경 변수가 필요합니다.

  • SERPAPI_KEY : SerpAPI 키(필수)

API

서버는 구성 가능한 매개변수를 사용하여 단일 MCP 도구를 구현합니다.

DuckDuckGo 검색 엔진을 사용하여 웹 검색을 수행하세요.

매개변수:

  • query (문자열, 필수): 검색 쿼리
  • region (문자열, 선택 사항): 지역 코드(예: us-en, uk-en)(기본값: us-en)
  • safe_search (문자열, 선택 사항): 안전 검색 수준(해제, 보통, 엄격)(기본값: 보통)
  • date_filter (문자열, 선택 사항): 날짜별로 결과를 필터링합니다.
    • 'd': 지난 날
    • 'w': 지난주
    • 'm': 지난 달
    • 'y': 작년
    • 사용자 지정 범위: '2023-01-01..2023-12-31'
  • start (숫자, 선택 사항): 페이지 매김을 위한 결과 오프셋
  • no_cache (부울, 선택 사항): 최신 결과에 대해 캐시를 우회합니다(기본값: false)

응답에는 다음이 포함됩니다.

  • 사용 가능한 경우 지식 그래프 데이터
  • 유기적 검색 결과
  • 뉴스 기사
  • 비디오 콘텐츠
  • 이미지 결과
  • 관련 검색
  • 검색 메타데이터

개발

설정

  1. 저장소를 복제합니다
  2. 종속성 설치:
pnpm install
  1. 프로젝트를 빌드하세요:
pnpm build
  1. 개발 모드에서 실행:
pnpm dev

출판

이 프로젝트에서는 버전 관리를 위해 변경 세트를 사용합니다. 게시하려면 다음을 수행하세요.

  1. 변경 세트를 만듭니다.
pnpm changeset
  1. 패키지 버전:
pnpm changeset version
  1. npm에 게시:
pnpm release

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

-
security - not tested
A
license - permissive license
-
quality - not tested

LLM을 위한 DuckDuckGo 검색 기능과 통합하여 포괄적인 웹 검색, 지역 필터링, 결과 유형, 캐싱 및 사용자 정의 가능한 검색 매개변수를 통한 안전한 탐색을 지원합니다.

  1. ⚠️ Notice
    1. Features
      1. Configuration
        1. Cline Configuration
        2. Claude Desktop with WSL Configuration
        3. Environment Variables
      2. API
        1. ddg_search
      3. Development
        1. Setup
        2. Publishing
      4. Contributing
        1. License
          1. Acknowledgments
            ID: v99lwtriyk