This project was created by the AI code editor "Cursor". The large language model (LLM) used by Cursor is "GPT-4.1". Detailed specifications are documented in specifications.md.

DuckDuckGo MCP Server

DuckDuckGoの検索機能を提供するModel Context Protocol (MCP) サーバーです。

対応アプリケーション

• Claude Desktop - Mac/Windows/Linux
• Cursor IDE - AI搭載コードエディター
• その他のMCP対応アプリケーション

機能

• DuckDuckGoでのWebページ検索
• 検索結果の要約と詳細情報の取得
• 非同期処理による高速な検索
• フォールバック機能による安定性確保

前提条件

• Python 3.11以降 (推奨: Python 3.13)
• uv パッケージマネージャー (推奨) または pip

セットアップ

uv を使用する場合（推奨）

1. uv をインストールします:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. プロジェクトの依存関係をインストールします:

uv sync

3. サーバーの起動:

uv run duckduckgo-mcp-server
# または
python run.py

従来の方法（pip）

1. 依存関係のインストール:

pip install -r requirements.txt

2. サーバーの起動:

python server.py

使用方法

このMCPサーバーは以下のツールを提供します:

• search_duckduckgo: DuckDuckGoで検索を実行

設定

特別な設定は不要です。DuckDuckGoのAPIは無料で利用可能です。

テスト

uv を使用する場合

uv run test-search
# または
python run.py test

従来の方法

python test_search.py

Docker での実行

Docker環境でも実行可能です（Python 3.13 + uvとpipの両方をサポート）:

# ビルドと起動
docker compose up --build -d

# テスト実行
docker compose --profile testing up test-runner

# 停止
docker compose down

MCP クライアントでの使用

Claude Desktop

詳細は CLAUDE_DESKTOP_SETUP.md を参照してください。

ローカル環境（uv）

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "uv",
      "args": ["run", "duckduckgo-mcp-server"],
      "cwd": "/path/to/duckduckgo-mcp-server",
      "env": {}
    }
  }
}

Cursor IDE

詳細は CURSOR_SETUP.md を参照してください。

プロジェクト設定（.cursor/mcp.json）

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "uv",
      "args": ["run", "duckduckgo-mcp-server"],
      "env": {}
    }
  }
}

グローバル設定（~/.cursor/mcp.json）

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "uv",
      "args": ["run", "duckduckgo-mcp-server"],
      "env": {}
    }
  }
}

リモート環境での使用

SSH経由でリモートサーバー上のMCP Serverを利用する場合は CONNECTION_SOLUTION.md を参照してください。

トラブルシューティング

問題が発生した場合は以下を参照してください：

• TROUBLESHOOTING.md - 一般的な問題と解決方法
• CONNECTION_SOLUTION.md - リモート接続問題の解決方法
• IMPORTANT_NOTES.md - 重要な設定ポイント

ライセンス

MIT License