DuckDuckGo Web Search MCP Server

DuckDuckGo Web Search MCP サーバー

このプロジェクトは、DuckDuckGo 検索エンジンを使ってウェブを検索し、任意で見つかった URL のコンテンツを取得して要約できる MCP（Model Context Protocol）サーバーを提供します。

機能

• ウェブ検索： DuckDuckGo を使ってウェブを検索します。
• 検索結果の抽出： 検索結果からタイトル、URL、スニペットを抽出します。
• コンテンツの取得（任意）： 検索結果で見つかった URL のコンテンツを取得し、jina api を使って Markdown 形式に変換します。
• 並列取得： 複数の URL を同時に取得し、処理を高速化します。
• エラー処理： 検索や取得中に発生するタイムアウトなどのエラーを適切に処理します。
• 設定可能： 返す検索結果の最大数を設定できます。
• Jina API：jina api を使って HTML を Markdown に変換します。
• MCP 準拠：このサーバーは、MCP 互換のあらゆるクライアントで使用できるよう設計されています。

使用方法

1. 前提条件：

   • uvx パッケージマネージャー

2. Claude Desktop の設定

   • Claude Desktop を使用している場合は、claude_desktop_config.json ファイルにサーバーを追加できます。

   {
       "mcpServers": {
           "web-search-duckduckgo": {
               "command": "uvx",
               "args": [
                   "--from",
                   "git+https://github.com/kouui/web-search-duckduckgo.git@main",
                   "main.py"
               ]
           }
       }
   }
   

   上記の設定は動作しないため、リポジトリをローカル PC にクローンし、次の設定を使用する必要がある場合があります。

   {
       "mcpServers": {
           "web-search-duckduckgo": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/path/to/web-search-duckduckgo",
                   "run",
                   "main.py"
               ]
           }
       }
   }
   

3. ツール

   • MCP クライアント（例：Claude）で、次のツールを使用できるようになります。

   • search_and_fetch： ウェブを検索し、URL のコンテンツを取得します。

     • query：検索クエリ文字列。
     • limit：返す検索結果の最大数（デフォルト：3、最大：10）。

   • fetch： 指定した URL のコンテンツを取得します。

     • url：取得する URL。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。（ライセンスを指定する場合は、ライセンスファイルを追加してください。）