DuckDuckGo搜索MCP服务器

这是一个通过DuckDuckGo提供网络搜索功能的模型上下文协议(MCP)服务器，并具备内容获取与解析的附加特性。

功能特性

• 网络搜索：通过高级速率限制和结果格式化功能搜索DuckDuckGo
• 内容获取：使用智能文本提取技术检索并解析网页内容
• 速率限制：内置保护机制，防止搜索和内容获取时的速率限制
• 错误处理：全面的错误处理与日志记录
• LLM友好输出：专门为大型语言模型消费而格式化的结果

安装方式

通过Smithery安装

要自动通过Smithery为Claude Desktop安装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检查器运行
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
• 格式化结果以优化LLM消费
• 适当截断长内容

错误处理

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

贡献指南

欢迎提交问题和拉取请求！一些潜在的改进方向：

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

许可证

本项目采用MIT许可证。