通过DuckDuckGo搜索的MCP服务器

一个提供基于DuckDuckGo网络搜索功能的Model Context Protocol (MCP)服务器，并附带内容抓取和解析的额外功能。

特性

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

返回： 包含标题、链接和摘录的格式化字符串。

2. 内容抓取工具

async def fetch_content(url: str) -> str

从指定URL获取并解析网页内容，返回文本格式的结果。

参数：

• url：要抓取的内容URL

返回： 提取的纯文本内容

详细功能说明

• 搜索功能：

  • 支持异步请求，提高效率。
  • 内置速率限制，防止API调用过载。
  • 结果自动格式化，便于后续处理。

• 内容抓取功能：

  • 可以从指定URL获取网页内容。
  • 带有错误处理机制，确保在无法访问时返回友好的提示信息。
  • 支持多种内容解析方式，适应不同网页结构。

使用示例

搜索示例

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

输出结果可能类似于：

标题：Python编程 - 维基百科
链接：https://zh.wikipedia.org/wiki/Python_(编程语言)
摘录：Python是一种高级编程语言，以其易读性著称。
...

内容抓取示例

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

输出结果可能类似于：

这是一个示例网页内容。欢迎来到我们的网站！

贡献指南

我们欢迎社区贡献，以下是一些可能的改进方向：

• 添加更多搜索参数（如过滤条件、排序选项）。
• 优化内容抓取算法，提高解析准确性。
• 实现缓存机制，提升重复请求效率。
• 支持多语言内容处理。
• 增加错误处理日志的详细程度。

请通过提交GitHub问题或Pull Request的方式参与贡献。