DuckDuckGo 搜索 MCP 服务器

这是一个通过DuckDuckGo提供网络搜索能力的模型上下文协议（MCP）服务器，并具有内容抓取和解析的额外功能。

<a href="https://glama.ai/mcp/servers/phcus2gcpn"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=3501384487,2971533191&fm=3081&app=3081&f=PNG?w=760&h=400" alt="DuckDuckGo Server MCP 服务器" /> </a>

功能

• 网络搜索：通过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

可用工具

1. 搜索工具

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

在 DuckDuckGo 上执行网络搜索并返回格式化的结果。

参数：

• query：搜索查询字符串
• max_results：返回的最大结果数（默认：10）

返回值： 包含搜索结果标题、URL 和摘要的格式化字符串。

2. 内容抓取工具

async def fetch_content(url: str) -> str

抓取并解析网页内容。

参数：

• url：要抓取内容的网页 URL

返回值： 来自网页的清理和格式化后的文本内容。

功能详解

速率限制

• 搜索：每分钟限30次请求
• 内容抓取：每分钟限20次请求
• 自动队列管理和等待时间

结果处理

• 移除广告和无关内容
• 清理 DuckDuckGo 跳转 URL
• 格式化结果以优化大型语言模型的消费
• 合适地截断长内容

错误处理

• 全面的错误捕获和报告
• 通过 MCP 上下文进行详细的日志记录
• 在超出速率限制或超时时优雅降级

贡献

欢迎提出问题和拉取请求！一些潜在改进领域：

• 增加搜索参数（地区、语言等）
• 增强内容解析选项
• 经常访问内容的缓存层
• 更多的速率限制策略

许可证

本项目采用 MIT 许可证。