Nickclyde Duckduckgo MCP Server

🚀 通過DuckDuckGo搜索的MCP服務器

這是一個提供基於DuckDuckGo網絡搜索功能的Model Context Protocol (MCP)服務器，還附帶了內容抓取和解析的額外功能，能為用戶提供更全面的信息獲取體驗。

🚀 快速開始

該MCP服務器可提供基於DuckDuckGo的網絡搜索功能，同時具備內容抓取和解析能力。你可以按照以下步驟進行安裝和使用。

✨ 主要特性

• 網絡搜索：藉助DuckDuckGo進行高級搜索，帶有速率限制和結果格式化功能，讓搜索更高效、有序。
• 內容抓取：能夠獲取並解析網頁內容，具備智能文本提取功能，精準提取所需信息。
• 速率限制：內置保護機制，有效防止搜索和內容抓取的速率超限，保障服務器穩定運行。
• 錯誤處理：擁有全面的錯誤捕捉與日誌記錄功能，便於及時發現和解決問題。
• 適合大語言模型的輸出格式：專為大型語言模型設計的結果呈現方式，方便模型處理和應用。

📦 安裝指南

通過Smithery安裝

使用Smithery可自動安裝DuckDuckGo搜索服務器以供Claude Desktop使用，執行以下命令：

npx -y @smithery/cli install @nickclyde/duckduckgo-mcp-server --client claude

通過uv直接安裝

直接從PyPI使用uv進行安裝，命令如下：

uv pip install duckduckgo-mcp-server

💻 使用示例

在Claude Desktop上的運行

1. 下載Claude Desktop。
2. 創建或編輯Claude Desktop配置文件：
   • 在macOS上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在Windows上：%APPDATA%\Claude\claude_desktop_config.json 在配置文件中添加以下內容：

{
    "mcpServers": {
        "ddg-search": {
            "command": "uvx",
            "args": ["duckduckgo-mcp-server"]
        }
    }
}

3. 重啟Claude Desktop。

開發環境使用

在本地進行開發時，可使用MCP CLI：

# 使用MCP Inspector運行
mcp dev server.py

# 安裝用於與Claude Desktop測試
mcp install server.py

基礎用法

搜索示例

result = await search("Python編程")
print(result)

輸出結果可能類似於：

標題：Python編程 - 維基百科
鏈接：https://zh.wikipedia.org/wiki/Python_(編程語言)
摘錄：Python是一種高級編程語言，以其易讀性著稱。
...

內容抓取示例

content = await fetch_content("https://www.example.com")
print(content)

輸出結果可能類似於：

這是一個示例網頁內容。歡迎來到我們的網站！

高級用法

在實際開發中，你可以根據需求調整搜索參數和內容抓取方式，以滿足不同場景的需求。例如，在搜索時可以設置更多的過濾條件和排序選項，在內容抓取時可以選擇更適合的解析方式。

📚 詳細文檔

可用工具

1. 搜索工具

async def search(query: str, max_results: int = 10) -> str

在DuckDuckGo上執行網絡搜索並返回格式化結果。 參數：

• query：搜索查詢字符串。
• max_results：要返回的最大結果數（默認值為10）。 返回：包含標題、鏈接和摘錄的格式化字符串。

2. 內容抓取工具

async def fetch_content(url: str) -> str

從指定URL獲取並解析網頁內容，返回文本格式的結果。 參數：

• url：要抓取的內容URL。 返回：提取的純文本內容。

詳細功能說明

• 搜索功能：
  • 支持異步請求，顯著提高搜索效率。
  • 內置速率限制，有效防止API調用過載，保障搜索服務的穩定性。
  • 結果自動格式化，便於後續處理和使用。
• 內容抓取功能：
  • 可以從指定URL獲取網頁內容。
  • 帶有錯誤處理機制，確保在無法訪問時返回友好的提示信息。
  • 支持多種內容解析方式，能夠適應不同網頁結構，提高內容提取的準確性。

🔧 技術細節

該服務器基於DuckDuckGo的搜索API實現搜索功能，通過異步編程提高搜索效率。在內容抓取方面，採用了多種解析方式，以適應不同網頁結構。同時，內置了速率限制和錯誤處理機制，保障服務器的穩定運行。

🤝 貢獻指南

我們歡迎社區貢獻，以下是一些可能的改進方向：

• 添加更多搜索參數（如過濾條件、排序選項）。
• 優化內容抓取算法，提高解析準確性。
• 實現緩存機制，提升重複請求效率。
• 支持多語言內容處理。
• 增加錯誤處理日誌的詳細程度。 請通過提交GitHub問題或Pull Request的方式參與貢獻。