Duckduckgo MCP Server

🚀 ダックダックゴ検索 MCP サーバー

English | 中文

TypeScript ベースの MCP サーバーで、ダックダックゴ検索機能を提供します。以下の点で MCP の核心概念を実演します。

• ダックダックゴ検索の統合
• 使いやすい検索ツールインターフェイス
• レート制限とエラー処理のサポート

✨ 主な機能

検索ツール

• duckduckgo_search - ダックダックゴ API を使用したウェブ検索
  • 必須パラメータ：query（検索クエリ、最大 400 文字）
  • オプションパラメータ：count（結果数、1 - 20、デフォルトは 10）
  • オプションパラメータ：safeSearch（セキュリティレベル：厳格/緩和/無効、デフォルトは緩和）
  • フォーマットされた Markdown 検索結果を返す

レート制限

• 最大 1 秒あたり 1 リクエスト
• 月あたり最大 15000 リクエスト

📦 インストール

前提条件

• Node.js >= 18
• pnpm >= 8.0.0

インストール手順

# まだインストールされていない場合、pnpm をインストール
npm install -g pnpm

# プロジェクトの依存関係をインストール
pnpm install

ビルドと実行

サーバーをビルド：

pnpm run build

開発時の自動再構築：

pnpm run watch

📚 ドキュメント

Claude Desktop での設定

Claude Desktop と一緒に使用するには、サーバー設定を追加してください。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json%

# オンライン設定
{
  "mcpServers": {
    "duckduckgo-search": {
        "command": "npx",
        "args": [
          "-y",
          "duckduckgo-mcp-server"
        ]
    }
  }
}

# ローカル設定
{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "node",
      "args": [
        "/path/to/duckduckgo-search/build/index.js"
      ]
    }
  }
}

デバッグ

MCP サーバーは stdio を通じて通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして提供されます。

pnpm run inspector

Inspector はブラウザのデバッグツールにアクセスするための URL を提供します。