mcp-duckduckgo-search

⚠️ 通知

此仓库已不再维护。

该工具的功能现在已整合到 mcp-omnisearch 中，它将多个 MCP 工具合并到一个统一的包中。

请改用 mcp-omnisearch。

这是一个用于将 DuckDuckGo 搜索功能与 LLMs 集成的 Model Context Protocol (MCP) 服务器。该服务器提供了全面的网页搜索功能，并支持多种结果类型和过滤选项。

功能

• 🔍 使用 DuckDuckGo 的搜索引擎进行全面的网页搜索
• 📊 丰富的结果类型，包括：
  • 知识图谱信息
  • 自然搜索结果
  • 新闻文章
  • 视频内容
  • 图片结果
  • 相关搜索
• 🌍 区域特定搜索支持
• 🛡️ 可配置的安全搜索级别
• 📅 基于日期的过滤选项
• 📄 分页支持
• 💾 内置结果缓存
• 🔒 安全搜索选项（关闭、适度、严格）

配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境下的示例：

Cline 配置

将以下内容添加到您的 Cline MCP 设置中：

{
    "mcpServers": {
        "mcp-duckduckgo-search": {
            "command": "npx",
            "args": ["-y", "mcp-duckduckgo-search"],
            "env": {
                "SERPAPI_KEY": "your-serpapi-api-key"
            }
        }
    }
}

Claude Desktop with WSL 配置

对于 WSL 环境，请将以下内容添加到您的 Claude Desktop 配置中：

{
    "mcpServers": {
        "mcp-duckduckgo-search": {
            "command": "wsl.exe",
            "args": [
                "bash",
                "-c",
                "source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
            ]
        }
    }
}

环境变量

服务器需要以下环境变量：

• SERPAPI_KEY: 您的 SerpAPI 密钥（必需）

API

服务器实现了一个具有可配置参数的 MCP 工具：

ddg_search

使用 DuckDuckGo 搜索引擎执行网页搜索。

参数：

• query (字符串，必需): 搜索查询
• region (字符串，可选): 区域代码（例如：us-en, uk-en）(默认: us-en)
• safe_search (字符串，可选): 安全搜索级别（off, moderate, strict）(默认: moderate)
• date_filter (字符串，可选): 按日期过滤结果：
  • 'd': 过去一天
  • 'w': 过去一周
  • 'm': 过去一个月
  • 'y': 过去一年
  • 自定义范围: '2023-01-01..2023-12-31'
• start (数字，可选): 结果分页偏移量
• no_cache (布尔值，可选): 绕过缓存以获取最新结果 (默认: false)

响应包括：

• 可用的知识图谱数据
• 自然搜索结果
• 新闻文章
• 视频内容
• 图片结果
• 相关搜索
• 搜索元数据

开发

设置

1. 克隆仓库
2. 安装依赖项：

pnpm install

1. 构建项目：

pnpm build

1. 以开发模式运行：

pnpm dev

发布

该项目使用 changesets 进行版本管理。要发布：

1. 创建一个 changeset：

pnpm changeset

1. 对包进行版本控制：

pnpm changeset version

1. 发布到 npm：

pnpm release

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 基于
  Model Context Protocol
• 通过
  SerpAPI 由 DuckDuckGo 支持