# mcp-duckduckgo-search

A Model Context Protocol (MCP) server for integrating DuckDuckGo
search capabilities with LLMs. This server provides comprehensive web
search functionality with support for various result types and
filtering options.

<a href="https://glama.ai/mcp/servers/v99lwtriyk">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/v99lwtriyk/badge" />
</a>

## Features

- 🔍 Comprehensive web search using DuckDuckGo's search engine
- 📊 Rich result types including:
  - Knowledge graph information
  - Organic search results
  - News articles
  - Video content
  - Image results
  - Related searches
- 🌍 Region-specific search support
- 🛡️ Configurable safe search levels
- 📅 Date-based filtering options
- 📄 Pagination support
- 💾 Built-in result caching
- 🔒 Safe search options (off, moderate, strict)

## Configuration

This server requires configuration through your MCP client. Here are
examples for different environments:

### Cline Configuration

Add this to your Cline MCP settings:

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

### Claude Desktop with WSL Configuration

For WSL environments, add this to your Claude Desktop configuration:

```json
{
	"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"
			]
		}
	}
}
```

### Environment Variables

The server requires the following environment variable:

- `SERPAPI_KEY`: Your SerpAPI key (required)

## API

The server implements a single MCP tool with configurable parameters:

### ddg_search

Perform web searches using the DuckDuckGo search engine.

Parameters:

- `query` (string, required): Search query
- `region` (string, optional): Region code (e.g., us-en, uk-en)
  (default: us-en)
- `safe_search` (string, optional): Safe search level (off, moderate,
  strict) (default: moderate)
- `date_filter` (string, optional): Filter results by date:
  - 'd': past day
  - 'w': past week
  - 'm': past month
  - 'y': past year
  - Custom range: '2023-01-01..2023-12-31'
- `start` (number, optional): Result offset for pagination
- `no_cache` (boolean, optional): Bypass cache for fresh results
  (default: false)

Response includes:

- Knowledge graph data when available
- Organic search results
- News articles
- Video content
- Image results
- Related searches
- Search metadata

## Development

### Setup

1. Clone the repository
2. Install dependencies:

```bash
pnpm install
```

3. Build the project:

```bash
pnpm build
```

4. Run in development mode:

```bash
pnpm dev
```

### Publishing

The project uses changesets for version management. To publish:

1. Create a changeset:

```bash
pnpm changeset
```

2. Version the package:

```bash
pnpm changeset version
```

3. Publish to npm:

```bash
pnpm release
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

MIT License - see the [LICENSE](LICENSE) file for details.

## Acknowledgments

- Built on the
  [Model Context Protocol](https://github.com/modelcontextprotocol)
- Powered by [DuckDuckGo](https://duckduckgo.com) through
  [SerpAPI](https://serpapi.com)