MCP Duckduckresearch

🚀 MCP 鴨々研究者

MCP（モデルコンテキストプロトコル）サーバーで、DuckDuckGo検索機能、ウェブコンテンツの抽出、スクリーンショット機能を統合しています。このサーバーは、情報検索とプログラムによるウェブコンテンツへのアクセスとの間のギャップを埋めます。

✨ 主な機能

• 🔍 DuckDuckGo 検索：DuckDuckGo検索エンジンを使用してウェブ検索を行います。
• 📄 コンテンツ抽出：ウェブページにアクセスし、その内容をMarkdown形式で抽出します。
• 📸 スクリーンショット取得：ウェブページのスクリーンショットを撮影し、自動的にサイズを最適化します。
• ⚡ 強力なエラー処理：組み込みのロボット検出防止とコンテンツ検証保護があります。
• 🔒 安全な検索オプション：適切なコンテンツフィルタリングのために、設定可能な安全な検索レベルがあります。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/mcp-duckduckresearch.git
cd mcp-duckduckresearch

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

Clineのインストールと設定

1. まず、上記の手順でプロジェクトをビルドします。
2. Cline設定でMCPサーバーを構成します。

以下の場所にあるファイルを編集します： %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

以下の設定を追加します：

{
  "mcpServers": {
   "duckduckmcp": {
     "command": "node",
     "args": ["path/to/mcp-duckduckresearch/build/index.js"],
     "disabled": false,
     "alwaysAllow": []
   }
 }
}

path/to/mcp-duckduckresearch を実際にクローンしたリポジトリのパスに置き換えてください。

利用可能なツール

設定が完了すると、以下のツールがRooコードで利用できます。

1. search_duckduckgo

DuckDuckGoを使ってウェブ検索を行います。Rooコードでの使用例：

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>search_duckduckgo</tool_name>
<arguments>
{
  "query": "typescript best practices",
  "options": {
    "region": "zh-cn",
    "safeSearch": "MODERATE",
    "numResults": 10
  }
}
</arguments>
</use_mcp_tool>

2. visit_page

ウェブページにアクセスし、その内容をMarkdown形式で抽出します。

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>visit_page</tool_name>
<arguments>
{
  "url": "https://example.com",
  "takeScreenshot": false
}
</arguments>
</use_mcp_tool>

3. take_screenshot

現在読み込まれているウェブページのスクリーンショットを撮影します。

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>take_screenshot</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

Rooコードでの完全な使用例

以下は、情報を検索し、検索結果のページにアクセスする完全な例です。

1. まず検索を行います。

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>search_duckduckgo</tool_name>
<arguments>
{
  "query": "人工知能",
  "options": {
    "region": "zh-cn",
    "safeSearch": "MODERATE",
    "numResults": 5
  }
}
</arguments>
</use_mcp_tool>

2. 検索結果のウェブページにアクセスします。

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>visit_page</tool_name>
<arguments>
{
  "url": "https://example.com",
  "takeScreenshot": true
}
</arguments>
</use_mcp_tool>

🔧 テスト

このプロジェクトはVitestを使ってテストを行っています。テストは以下のカテゴリに分けられます。

• 単体テスト：個々のコンポーネントと関数をテストします。
• 統合テスト：完全な操作フローをテストします。
• テストカバレッジ：目標は80％以上のカバレッジです。

テストを実行するには：

# すべてのテストを実行する
npm test

# カバレッジ付きでテストを実行する
npm run test:coverage

🔨 貢献方法

1. リポジトリをフォークしてクローンします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m '素敵な機能を追加'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Requestを開きます。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

貢献者

• duck-duck-scrape - DuckDuckGo検索の実装
• Playwright - ブラウザー自動化とスクリーンショット
• モデルコンテキストプロトコル - MCP仕様とSDK