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 ツールを 1 つの統合パッケージにまとめたmcp-omnisearchで利用できるようになりました。

代わりにmcp-omnisearchを使用してください。


DuckDuckGoの検索機能をLLMに統合するためのモデルコンテキストプロトコル(MCP)サーバー。このサーバーは、様々な結果タイプとフィルタリングオプションをサポートする包括的なWeb検索機能を提供します。

特徴

  • 🔍 DuckDuckGoの検索エンジンを使った包括的なウェブ検索
  • 📊 リッチリザルトタイプには以下が含まれます:
    • ナレッジグラフ情報
    • オーガニック検索結果
    • ニュース記事
    • ビデオコンテンツ
    • 画像結果
    • 関連検索
  • 🌍 地域別検索サポート
  • 🛡️ 設定可能なセーフサーチレベル
  • 📅 日付ベースのフィルタリングオプション
  • 📄 ページネーションのサポート
  • 💾 結果キャッシュを内蔵
  • 🔒 セーフサーチのオプション(オフ、中、厳格)

構成

このサーバーはMCPクライアント経由で設定する必要があります。以下に、様々な環境における設定例を示します。

傾斜構成

Cline MCP 設定に以下を追加します:

{ "mcpServers": { "mcp-duckduckgo-search": { "command": "npx", "args": ["-y", "mcp-duckduckgo-search"], "env": { "SERPAPI_KEY": "your-serpapi-api-key" } } } }

WSL 構成の Claude デスクトップ

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 検索エンジンを使用して Web 検索を実行します。

パラメータ:

  • query (文字列、必須): 検索クエリ
  • region (文字列、オプション):地域コード(例:us-en、uk-en)(デフォルト:us-en)
  • safe_search (文字列、オプション):セーフサーチレベル(オフ、中程度、厳格)(デフォルト:中程度)
  • date_filter (文字列、オプション): 日付で結果をフィルタリングします。
    • 'd': 過去日
    • 'w': 過去1週間
    • 'm': 過去1か月
    • 'y': 過去1年
    • カスタム範囲: '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 検索機能との統合を可能にし、包括的な Web 検索、地域フィルタリング、結果タイプ、キャッシュとカスタマイズ可能な検索パラメータによる安全なブラウジングをサポートします。

  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