Metadata-Version: 2.4
Name: ddgs-mcp-server
Version: 0.1.0
Summary: DuckDuckGo Search MCP Server
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: duckduckgo-search>=6.0.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# DDGS MCP Server

A Model Context Protocol (MCP) server that provides DuckDuckGo Search capabilities to AI agents.

## Features

- **Text Search**: General web search (`search_text`)
- **Image Search**: Find images (`search_images`)
- **Video Search**: Find videos (`search_videos`)
- **News Search**: Get latest news (`search_news`)
- **Book Search**: Search for books (`search_books`)

## Installation & Usage

You can run this server directly using `uvx` without installing it globally.

### VS Code (Claude Desktop / Cline)

Add this to your MCP settings file (e.g., `cline_mcp_settings.json` or `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "ddgs-search": {
      "command": "uvx",
      "args": [
        "ddgs-mcp-server"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}
```

### Manual Execution

```bash
uvx ddgs-mcp-server
```

## Development / Publishing

To build and publish this package to PyPI:

1.  **Build**:
    ```bash
    pip install build twine
    python -m build
    ```

2.  **Publish**:
    ```bash
    python -m twine upload dist/*
    ```
