MCP Duckduckresearch

🚀 MCP DuckDuck Researcher

An MCP (Model Context Protocol) server that combines DuckDuckGo search functionality, web content extraction, and screenshot capture. This server bridges the gap between information retrieval and programmatic access to web content.

🚀 Quick Start

The MCP DuckDuck Researcher is a powerful tool that integrates DuckDuckGo search, web content extraction, and screenshot capture. It fills the gap between information retrieval and programmatic access to web content.

✨ Features

• 🔍 DuckDuckGo Search: Conduct web searches using the DuckDuckGo search engine.
• 📄 Content Extraction: Access web pages and extract their content into Markdown format.
• 📸 Screenshot Capture: Take screenshots of web pages and automatically optimize their dimensions.
• ⚡ Robust Error Handling: Built - in protection against bot detection and content validation.
• 🔒 Safe Search Options: Configurable safe search levels for appropriate content filtering.

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-duckduckresearch.git
cd mcp-duckduckresearch

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Installation and Configuration for Cline

1. First, build the project using the steps above.
2. Configure the MCP server in Cline settings:

Edit the file located at: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

Add the following configuration:

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

Replace path/to/mcp-duckduckresearch with the actual path where you cloned the repository.

Available Tools

After configuration, the following tools will be available in Roo code:

1. search_duckduckgo

Search the web using DuckDuckGo. Example usage in Roo code:

<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

Access a web page and extract its content into Markdown format:

<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

Take a screenshot of the currently loaded web page:

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

Complete Example Workflow in Roo Code

The following is a complete example of searching for information and accessing the results:

1. First, perform a search:

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

2. Access a web page from the search results:

<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>

📚 Documentation

Testing

The project uses Vitest for testing. The tests are divided into:

• Unit Tests: Test individual components and functions.
• Integration Tests: Test the complete operation flow.
• Test Coverage: The goal is to achieve >80% coverage.

Run the tests:

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

Contribution

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing features').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Contributors

• duck-duck-scrape - DuckDuckGo search implementation
• Playwright - Browser automation and screenshot capture
• Model Context Protocol - MCP specification and SDK