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の検索機能を提供するModel Context Protocol (MCP) サーバーです。

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

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

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

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

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

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

uv sync

3. サーバーの起動:

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

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

pip install -r requirements.txt

2. サーバーの起動:

python server.py

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

• search_duckduckgo: DuckDuckGoで検索を実行

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

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

python test_search.py

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

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

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

# 停止
docker compose down

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

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

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

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

{
  "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