Duckduckgo MCP Server

🚀 DuckDuckGoを通じたMCPサーバー

DuckDuckGoのウェブ検索機能を提供するモデルコンテキストプロトコル（MCP）サーバーで、コンテンツの取得と解析の追加機能も備えています。

🚀 クイックスタート

このサーバーは、DuckDuckGoを利用したウェブ検索機能を提供し、コンテンツの取得と解析も行えます。以下に、インストール方法と使用方法を説明します。

✨ 主な機能

• ウェブ検索：DuckDuckGoを使用した高度なレート制限と結果のフォーマット
• コンテンツ取得：ウェブページのコンテンツを取得して解析し、スマートなテキスト抽出を実現
• レート制限：検索とコンテンツ取得のレート保護機構が組み込まれています
• エラー処理：包括的なエラーキャプチャとログ記録
• 大規模言語モデルに適した出力：大規模言語モデル向けにフォーマットされた結果

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてDuckDuckGo検索サーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @nickclyde/duckduckgo-mcp-server --client claude

uvを使用したインストール

PyPIからuvを使用して直接インストールするには、以下のコマンドを実行します。

uv pip install duckduckgo-mcp-server

💻 使用例

Claude Desktopでの実行

1. Claude Desktopをダウンロードします。
2. Claude Desktopの設定を作成または編集します。
   • macOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windowsの場合：%APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します。

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

3. Claude Desktopを再起動します。

開発

ローカル開発では、MCP CLIを使用できます。

# MCP Inspectorを使用して実行
mcp dev server.py

# テスト用にClaude Desktopにインストール
mcp install server.py

基本的な使用法

# サーチツールの基本的な使用法
async def search(query: str, max_results: int = 10) -> str

この関数は、DuckDuckGoでウェブ検索を実行し、フォーマットされた結果を返します。

高度な使用法

# コンテンツ取得ツールの高度な使用法
async def fetch_content(url: str) -> str

この関数は、ウェブページからコンテンツを取得して解析します。

📚 ドキュメント

利用可能なツール

1. 検索ツール

async def search(query: str, max_results: int = 10) -> str

DuckDuckGoでウェブ検索を実行し、フォーマットされた結果を返します。

パラメータ:

• query: 検索クエリ文字列
• max_results: 返す最大結果数（デフォルトは10）

戻り値: タイトル、URL、抜粋を含むフォーマットされた文字列。

2. コンテンツ取得ツール

async def fetch_content(url: str) -> str

ウェブページからコンテンツを取得して解析します。

パラメータ:

• url: コンテンツを取得するウェブページのアドレス

戻り値: クリーンアップされたフォーマット済みのテキストコンテンツ。

🔧 技術詳細

レート制限

• 検索: 1分あたり最大30回のリクエスト
• コンテンツ取得: 1分あたり最大20回のリクエスト
• 自動キュー管理と待機時間

結果処理

• 広告や関係のないコンテンツを削除
• DuckDuckGoのリダイレクトURLをクリーンアップ
• 大規模言語モデルの使用体験を最適化するために結果をフォーマット
• 長いコンテンツを適切に切り捨てる

エラー処理

• 包括的なエラーキャプチャと報告
• MCPコンテキストを通じた詳細なログ記録
• レート制限やタイムアウトの場合にはエレガントなデグレード

🤝 貢献

問題の報告やプルリクエストは大歓迎です！いくつかの改善方向は以下の通りです。

• ドキュメント：既存のドキュメントを改善し、より多くの説明やチュートリアルを追加する。
• コード品質：コードベースをレビューして最適化し、コード品質を向上させる。
• 機能拡張：新しい機能を探索し、プロジェクトに組み込む。

GitHubリポジトリを訪問して、貢献ガイドやその他の詳細を確認してください。

📄 ライセンス

このプロジェクトのライセンス情報は、LICENSEファイルに記載されています。