Nickclyde Duckduckgo MCP Server

🚀 DuckDuckGoを通じたMCPサーバー

DuckDuckGoのウェブ検索機能を提供するModel Context Protocol (MCP)サーバーで、コンテンツの取得と解析の追加機能も備えています。

🚀 クイックスタート

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

✨ 主な機能

• ウェブ検索：DuckDuckGoを通じた高度な検索機能で、レート制限と結果の整形が可能です。
• コンテンツ取得：ウェブページのコンテンツを取得して解析し、スマートなテキスト抽出機能を備えています。
• レート制限：検索とコンテンツ取得のレート制限を防止するための保護機構が組み込まれています。
• エラー処理：包括的なエラー捕捉とログ記録機能があります。
• 大規模言語モデル向けの出力形式：大規模言語モデル向けに最適化された結果表示形式です。

📦 インストール

Smitheryを通じたインストール

Smitheryを使用して、Claude Desktop用の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でウェブ検索を実行し、整形された結果を返します。

パラメータ:

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

戻り値: タイトル、リンク、抜粋を含む整形された文字列。

コンテンツ取得ツール

async def fetch_content(url: str) -> str

指定されたURLからウェブページのコンテンツを取得して解析し、テキスト形式の結果を返します。

パラメータ:

• url：取得するコンテンツのURL

戻り値: 抽出された純粋なテキストコンテンツ

高度な使用法

検索例

result = await search("Python编程")
print(result)

出力結果は以下のようになる可能性があります。

タイトル：Python编程 - ウィキペディア
リンク：https://zh.wikipedia.org/wiki/Python_(プログラミング言語)
抜粋：Pythonは、その読みやすさで知られる高水準プログラミング言語です。
...

コンテンツ取得例

content = await fetch_content("https://www.example.com")
print(content)

出力結果は以下のようになる可能性があります。

これはサンプルのウェブページコンテンツです。当社のウェブサイトへようこそ！

📚 ドキュメント

• 検索機能：

  • 非同期リクエストをサポートし、効率を向上させます。
  • 組み込みのレート制限により、API呼び出しの過負荷を防止します。
  • 結果は自動的に整形され、後続の処理が容易になります。

• コンテンツ取得機能：

  • 指定されたURLからウェブページのコンテンツを取得できます。
  • エラー処理機構を備え、アクセスできない場合には分かりやすいメッセージを返します。
  • さまざまなコンテンツ解析方法をサポートし、さまざまなウェブページ構造に対応します。

🔧 コントリビューションガイド

コミュニティからの貢献を歓迎します。以下はいくつかの改善の方向性です。

• より多くの検索パラメータ（フィルタ条件、ソートオプションなど）を追加する。
• コンテンツ取得アルゴリズムを最適化し、解析精度を向上させる。
• キャッシュメカニズムを実装し、繰り返しのリクエストの効率を向上させる。
• 多言語コンテンツ処理をサポートする。
• エラー処理ログの詳細度を増やす。

貢献するには、GitHubのイシューまたはPull Requestを提出してください。