duckduckgo-search MCP Server

基本能力

产品定位

• 提供 DuckDuckGo 搜索功能的 MCP 服务器

核心功能

1. 搜索工具

2. duckduckgo_search：使用 DuckDuckGo API 执行网页搜索

   • 必需参数：query（搜索查询，最多 400 个字符）
   • 可选参数：count（结果数量，1-20，默认 10）
   • 可选参数：safeSearch（安全级别：strict/moderate/off，默认 moderate）
   • 返回格式化的 Markdown 搜索结果

3. 速率限制

4. 每秒最多 1 个请求
5. 每月最多 15000 个请求

适用场景

• 需要集成 DuckDuckGo 搜索功能的应用程序
• 需要速率限制和错误处理的搜索服务

使用教程

使用依赖

• Node.js >= 18
• pnpm >= 8.0.0

安装 pnpm（如果尚未安装）：

npm install -g pnpm

安装教程

安装项目依赖：

pnpm install

构建服务器：

pnpm run build

开发时自动重建：

pnpm run watch

在 Claude Desktop 中设置

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

在线配置：

{
  "mcpServers": {
    "duckduckgo-search": {
        "command": "npx",
        "args": [
          "-y",
          "duckduckgo-mcp-server"
        ]
    }
  }
}

本地配置：

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "node",
      "args": [
        "/path/to/duckduckgo-search/build/index.js"
      ]
    }
  }
}

调试方式

由于 MCP 服务器通过 stdio 进行通信，调试可能具有挑战性。推荐使用 MCP Inspector，它作为一个包脚本可用：

pnpm run inspector

Inspector 将提供一个 URL，用于在浏览器中访问调试工具。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。