duckduckgo-search MCP Server

duckduckgo-search MCP Server

英語 | 中文

DuckDuckGo Search 用の Model Context Protocol サーバー

これは、DuckDuckGo Search の検索機能を提供する TypeScript ベースの MCP サーバーです。次の機能を通じて、MCP の基本概念を紹介します。

• DuckDuckGo Search との連携
• 使いやすい検索ツールインターフェース
• レート制限とエラー処理のサポート

機能

検索ツール

• duckduckgo_search - DuckDuckGo API を使用してウェブ検索を実行します
  • 必須パラメーター：query（検索クエリ、最大 400 文字）
  • オプションのパラメーター：count（結果数、1～20、デフォルトは 10）
  • オプションのパラメーター：safeSearch（安全レベル：strict/moderate/off、デフォルトは moderate）
  • 書式設定された Markdown の検索結果を返します

レート制限

• 最大 1 リクエスト／秒
• 最大 15000 リクエスト／月

開発

前提条件

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

インストール

# Install pnpm if not already installed
npm install -g pnpm

# Install project dependencies
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

# online
{
  "mcpServers": {
    "duckduckgo-search": {
        "command": "npx",
        "args": [
          "-y",
          "duckduckgo-mcp-server"
        ]
    }
  }
}

# local
{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "node",
      "args": [
        "/path/to/duckduckgo-search/build/index.js"
      ]
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグは難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

pnpm run inspector

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