MCP DuckDuckGo Search Plugin

基本能力

产品定位

MCP DuckDuckGo Search Plugin 是一个为 MCP 协议设计的搜索插件，主要用于提供网页搜索功能，并支持高级导航和内容探索。

核心功能

• Web Search Tool: 使用 DuckDuckGo 进行网页搜索
• Detailed Results: 获取特定搜索结果的详细信息
• Related Searches: 基于原始搜索查询发现相关搜索词
• Pagination Support: 支持多页搜索结果导航
• Domain Extraction: 查看每个搜索结果的域名信息
• Advanced Filtering: 按站点和时间段过滤结果
• Enhanced Content Extraction: 从网页中提取丰富内容，包括元数据、结构和片段
• Basic Web Spidering: 从搜索结果中跟踪链接以探索相关内容（可配置深度）
• Metadata Extraction: 提取标题、作者、关键词、发布日期等
• Social Media Detection: 识别并提取网页中的社交媒体链接
• Content Structure Analysis: 提取标题和部分以理解网页结构
• Search Documentation: 访问关于搜索功能的全面文档
• Search Assistant: 帮助制定有效的搜索查询
• Parameterized Resource: 检索特定查询的格式化搜索结果

适用场景

• 在 Claude Code 或其他支持 MCP 的客户端中进行网页搜索
• 需要高级搜索过滤和导航的场景
• 需要从搜索结果中提取详细信息的场景
• 需要发现相关搜索词的场景

工具列表

1. duckduckgo_web_search: 使用 DuckDuckGo 进行网页搜索
2. duckduckgo_get_details: 获取特定搜索结果的详细信息
3. duckduckgo_related_searches: 基于原始查询发现相关搜索词
4. docs://search: 提供搜索功能的全面文档
5. search_assistant: 帮助制定有效的搜索查询
6. search://{query}: 检索特定查询的格式化搜索结果

常见问题解答

• 该插件使用 DuckDuckGo 的公共网页界面并解析 HTML 响应以提取结果
• 在生产环境中，建议使用具有官方 API 的搜索服务

使用教程

使用依赖

• Python 3.9 或更高版本
• pip (Python 包管理器)
• pyproject.toml 中列出的 Python 包

安装教程

从源代码安装

1. 克隆仓库: bash git clone https://github.com/gianlucamazza/mcp-duckduckgo.git cd mcp-duckduckgo
2. 安装包（开发模式）: bash pip install -e . 或使用提供的脚本: bash ./scripts/install_dev.sh 或使用 Make: bash make install

调试方式

手动启动服务器

mcp-duckduckgo

或使用自定义参数:

mcp-duckduckgo --host 127.0.0.1 --port 8000

或使用提供的脚本:

./scripts/run.sh

或使用 Make:

make run

与 Claude Code 一起使用

1. 按照上述方法从源代码安装包
2. 配置 Claude Code 使用插件: bash claude mcp add duckduckgo-search -- mcp-duckduckgo
3. 全局配置: bash claude mcp add duckduckgo-search --scope global -- mcp-duckduckgo
4. 启动 Claude Code: bash claude
5. 现在可以在 Claude Code 中使用 DuckDuckGo 搜索功能

许可证

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