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

クイックスタート

特徴

• ウェブ検索:高度なレート制限と結果フォーマット付きのDuckDuckGo検索
• コンテンツ取得:インテリジェントなテキスト抽出でウェブページのコンテンツを取得・解析する
• 長いURL短縮:長すぎる結果URLはfetch_contentが直接受け入れる短いref://トークンとなり、コンテキストを節約します
• レート制限:検索およびコンテンツ取得の両方に対するレート制限に対する組み込み保護
• エラー処理:包括的なエラー処理とログ記録
• LLM対応出力:大規模言語モデルの利用に特化した結果

設置

PyPIからuvを使ってインストールする方法:

使用法

Claude Desktopでランニング

1. Claude Desktopをダウンロードする
2. Claudeデスクトップの設定を作成または編集:

• macOSでは~/Library/Application Support/Claude/claude_desktop_config.json
• Windows版:%APPDATA%\Claude\claude_desktop_config.json

以下の構成を加えます:

基本設定(セーフサーチなし、デフォルトリージョンなし):

DuckDuckGo Search MCP Server

A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.

Quick Start

uvx duckduckgo-mcp-server

Features

• Web Search: Search DuckDuckGo with advanced rate limiting and result formatting
• Content Fetching: Retrieve and parse webpage content with intelligent text extraction
• Long URL Shortening: Over-long result URLs become short ref:// tokens that fetch_content accepts directly, saving context
• Rate Limiting: Built-in protection against rate limits for both search and content fetching
• Error Handling: Comprehensive error handling and logging
• LLM-Friendly Output: Results formatted specifically for large language model consumption

Installation

Install from PyPI using uv:

uv pip install duckduckgo-mcp-server

Usage

Running with Claude Desktop

1. Download Claude Desktop
2. Create or edit your Claude Desktop configuration:
   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

Basic Configuration (No SafeSearch, No Default Region):

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

With SafeSearch and Region Configuration:

{
    "mcpServers": {
        "ddg-search": {
            "command": "uvx",
            "args": ["duckduckgo-mcp-server"],
            "env": {
                "DDG_SAFE_SEARCH": "STRICT",
                "DDG_REGION": "cn-zh"
            }
        }
    }
}

Configuration Options:

• DDG_SAFE_SEARCH: SafeSearch filtering level (optional)
  • STRICT: Maximum content filtering (kp=1)
  • MODERATE: Balanced filtering (kp=-1, default if not specified)
  • OFF: No content filtering (kp=-2)
• DDG_REGION: Default region/language code (optional, examples below)
  • us-en: United States (English)
  • cn-zh: China (Chinese)
  • jp-ja: Japan (Japanese)
  • wt-wt: No specific region
  • Leave empty for DuckDuckGo’s default behavior
• DDG_CA_CERTS: Path to a PEM CA bundle used to verify TLS certificates on outbound requests (optional). Needed behind TLS-intercepting proxies — see Running behind a TLS-intercepting proxy.