MCP Duckduckresearch

🚀 MCP 鴨鴨研究者

MCP 鴨鴨研究者是一個結合了 DuckDuckGo 搜索功能、網頁內容提取和截圖功能的 MCP（模型上下文協議）服務器，它成功彌合了信息檢索與程序化訪問網絡內容之間的差距，為用戶提供便捷的網絡信息獲取途徑。

✨ 主要特性

• 🔍 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