Duckduckgo MCP Server

🚀 通過DuckDuckGo搜索的MCP服務器

一個提供DuckDuckGo網絡搜索功能的模型上下文協議（MCP）服務器，具備內容抓取和解析的額外功能，可助力用戶高效獲取網絡信息。

🚀 快速開始

本服務器是一個提供DuckDuckGo網絡搜索功能的模型上下文協議（MCP）服務器，具有內容抓取和解析的額外功能。

✨ 主要特性

• 網絡搜索：使用DuckDuckGo進行高級速率限制和結果格式化
• 內容抓取：獲取並解析網頁內容，實現智能文本提取
• 速率限制：內置搜索和內容抓取的速率保護機制
• 錯誤處理：全面的錯誤捕獲和日誌記錄
• 大語言模型友好的輸出：經過格式化的結果，專為大型語言模型設計

📦 安裝指南

通過Smithery安裝

要自動通過Smithery安裝DuckDuckGo搜索服務器：

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

可用工具

搜索工具

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

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

參數：

• query：搜索查詢字符串
• max_results：要返回的最大結果數（默認值為10）

返回： 包含標題、URL和摘錄的格式化字符串。

內容抓取工具

async def fetch_content(url: str) -> str

從網頁抓取並解析內容。

參數：

• url：要抓取內容的網頁地址

返回： 清理後的格式化文本內容。

📚 詳細文檔

功能細節

速率限制

• 搜索：每分鐘最多30次請求
• 內容抓取：每分鐘最多20次請求
• 自動隊列管理和等待時間

結果處理

• 移除廣告和無關內容
• 清理DuckDuckGo重定向URL
• 格式化結果以優化大語言模型的使用體驗
• 適當截斷長內容

錯誤處理

• 全面錯誤捕獲和報告
• 詳細日誌記錄通過MCP上下文
• 在速率限制或超時情況下實現優雅降級

🔧 技術細節

貢獻

歡迎提出問題和拉取請求！一些改進方向包括：

• 文檔：改進現有文檔，添加更多解釋和教程。
• 代碼質量：審查和優化代碼庫，提升代碼質量。
• 功能擴展：探索新功能並將其合併到項目中。

訪問GitHub倉庫查看貢獻指南和其他詳細信息。

📄 許可證

本項目的許可信息可以在LICENSE文件中找到。