MCP 鸭鸭研究者

一个结合了DuckDuckGo搜索功能、网页内容提取和截图功能的MCP（模型上下文协议）服务器。此服务器弥合了信息检索与程序化访问网络内容之间的差距。

功能

• 🔍 DuckDuckGo 搜索：使用DuckDuckGo搜索引擎进行网络搜索
• 📄 内容提取：访问网页并将其内容提取为Markdown格式
• 📸 截图捕获：拍摄网页的截图，并自动优化尺寸
• ⚡ 强大的错误处理：内置防机器人检测和内容验证保护
• 🔒 安全搜索选项：可配置的安全搜索级别，用于适当的内容过滤

安装

# 克隆仓库
git clone https://github.com/yourusername/mcp-duckduckresearch.git
cd mcp-duckduckresearch

# 安装依赖
npm install

# 构建项目
npm run build

使用Cline和Roo代码

Cline的安装配置

1. 首先使用上述步骤构建项目
2. 在Cline设置中配置MCP服务器：

编辑位于： %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

添加以下配置：

{
  "mcpServers": {
   "duckduckmcp": {
     "command": "node",
     "args": ["path/to/mcp-duckduckresearch/build/index.js"],
     "disabled": false,
     "alwaysAllow": []
   }
 }
}

将 path/to/mcp-duckduckresearch 替换为你实际克隆仓库的路径。

可用工具

配置完成后，以下工具将在Roo代码中可用：

1. search_duckduckgo

使用DuckDuckGo搜索网络。在Roo代码中的示例用法：

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>search_duckduckgo</tool_name>
<arguments>
{
  "query": "typescript best practices",
  "options": {
    "region": "zh-cn",
    "safeSearch": "MODERATE",
    "numResults": 10
  }
}
</arguments>
</use_mcp_tool>

2. visit_page

访问网页并提取其内容为Markdown格式：

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>visit_page</tool_name>
<arguments>
{
  "url": "https://example.com",
  "takeScreenshot": false
}
</arguments>
</use_mcp_tool>

3. take_screenshot

拍摄当前加载网页的截图：

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>take_screenshot</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

在Roo代码中的完整示例工作流程

以下是搜索信息并访问结果的完整示例：

1. 首先进行搜索：

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>search_duckduckgo</tool_name>
<arguments>
{
  "query": "人工智能",
  "options": {
    "region": "zh-cn",
    "safeSearch": "MODERATE",
    "numResults": 5
  }
}
</arguments>
</use_mcp_tool>

2. 访问搜索结果中的某个网页：

<use_mcp_tool>
<server_name>duckduckmcp</server_name>
<tool_name>visit_page</tool_name>
<arguments>
{
  "url": "https://example.com",
  "takeScreenshot": true
}
</arguments>
</use_mcp_tool>

测试

项目使用Vitest进行测试。测试分为：

• 单元测试：测试单个组件和函数
• 集成测试：测试完整的操作流程
• 测试覆盖率：目标是>80%的覆盖率

运行测试：

# 运行所有测试
npm test

# 带有覆盖率的测试
npm run test:coverage

贡献

1. 叉克隆仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加一些精彩的特性'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

许可证

此项目 licensed under the MIT License - 有关详细信息，请参阅LICENSE文件。

贡献者

• duck-duck-scrape - DuckDuckGo搜索实现
• Playwright - 浏览器自动化和截图
• 模型上下文协议 - MCP规范和SDK