Duckduckgo Search

🚀 MCP 鴨子🦆 插件

MCP 鴨子🦆 插件是一款強大的工具，可增強內容提取和網絡爬取功能。它藉助 DuckDuckGo 搜索進行內容抓取，還具備豐富的數據處理能力。

🚀 快速開始

你可以按照以下步驟快速使用 MCP 鴨子🦆 插件：

1. 安裝插件。
2. 啟動 MCP 服務器。
3. 安裝項目依賴。

具體操作請參考下面的安裝指南和使用說明。

✨ 主要特性

增強內容提取

該插件提供了強大的內容分析和抓取功能：

• 網頁分析：從 DuckDuckGo 搜索結果中提取並解析 HTML 內容。
• 智能內容識別：根據網站類型自動定位主要信息區域。
• 元數據提取：提取標題、描述、作者、關鍵詞和發佈日期等信息。
• 圖片檢測：識別網頁中的主要圖像和媒體資源。
• 社交鏈接提取：獲取網頁中嵌入的社交媒體鏈接。
• 內容結構分析：提取網頁中的 headings 和 sections，幫助理解頁面組織結構。
• 官方來源識別：通過域名和內容信號判斷信息源是否為官方渠道。

網頁爬取功能

插件還提供了基礎的網絡爬蟲功能：

• 可配置深度：從原始 URL 開始，最多遍歷 3 層鏈接。
• 鏈接限制：控制每頁要抓取的最大鏈接數（1 - 5）。
• 域名限制：可選開啟“僅在同一域名內抓取”選項。
• 相關內容發現：根據爬取結果分析和提取相關網頁內容。

📦 安裝指南

快速安裝

pip install mcp-duckduckgo

克隆倉庫（開發用途）

如果你需要對項目進行修改或貢獻代碼，可以先克隆倉庫：

git clone https://github.com/gianlucamazza/mcp-duckduckgo.git
cd mcp-duckduckgo
pip install -e .

💻 使用示例

初始化 MCP 服務器

運行以下命令啟動 MCP 服務器：

mcp-duckduckgo serve --port=8000

安裝依賴

在項目根目錄中，安裝所有依賴項：

pip install -r requirements.txt

📚 詳細文檔

項目結構

項目包含以下主要文件：

mcp_duckduckgo/
├── mcp_duckduckgo/    # 插件主代碼
│   ├── models.py       # 數據模型定義
│   ├── search.py       # 搜索功能實現
│   └── server.py       # MCP 服務器實現
└── scripts/            # 開發腳本
    ├── install_dev.sh  # 設置開發環境
    ├── run.sh          # 運行 MCP 服務器（開發模式）
    ├── test.sh         # 執行測試用例並生成覆蓋率報告
    └── lint.sh         # 執行代碼格式檢查和修復

開發腳本

項目提供了一些便利的腳本，位於 scripts/ 目錄中：

• install_dev.sh：安裝開發環境所需的依賴。
• run.sh：使用開發模式運行 MCP 服務器。
• test.sh：執行測試用例並生成覆蓋率報告。
• lint.sh：執行代碼格式檢查和修復。

測試指南

要在項目中執行測試，可以運行以下命令：

python -m pytest tests/ --cov=mcp_duckduckgo/

依賴管理

項目的依賴信息記錄在 requirements.txt 文件中。安裝所有依賴項：

pip install -r requirements.txt

貢獻指南

歡迎任何貢獻！請遵循以下步驟：

1. 克隆倉庫：git clone https://github.com/gianlucamazza/mcp-duckduckgo.git
2. 創建功能分支：git checkout -b feature/your-feature-name
3. 提交更改：git add . && git commit -m "添加新功能"
4. 推送到遠程倉庫：git push origin feature/your-feature-name
5. 提交 Pull Request 到主分支。

📄 許可證

項目使用 MIT 許可證，具體內容如下：

MIT License

感謝您對 MCP 鴨子🦆 插件的關注！如果有任何問題或建議，請隨時聯繫我們。