# ddg-mcp4

An awesome MCP generated by AI

## Features

- 🚀 Built with FastMCP framework
- 🔄 Supports both stdio and HTTP transports
- 🐳 Docker ready
- 📝 Type hints throughout
- 🧪 Test suite included
- ⚙️ GitHub Actions CI/CD

## Installation

1. Clone this repository
2. Create a virtual environment:
   ```bash
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   ```
3. Install dependencies:
   ```bash
   pip install -r requirements.txt
   pip install -e .
   ```

## Usage

### Stdio Transport (for Claude Desktop, etc.)

```bash
ddg_mcp4-mcp --transport stdio
```

### HTTP Transport (for web integration)

```bash
ddg_mcp4-mcp --transport streamable-http --port 8080
```

### Docker

```bash
# Build image
docker build -t ddg-mcp4 .

# Run container
docker run -p 8080:8080 ddg-mcp4
```

## Available Tools

- `example_tool`: Echo a message back
- `get_server_info`: Get information about this MCP server

## Development

### Running Tests

```bash
pip install pytest pytest-asyncio
pytest tests/
```

### Adding New Tools

1. Create a new function in `ddg_mcp4/app.py`
2. Decorate it with `@mcp.tool()`
3. Add proper type hints and docstring
4. The tool will automatically be available to MCP clients

Example:
```python
@mcp.tool()
async def my_new_tool(input_text: str) -> Dict[str, Any]:
    """
    Description of what this tool does.
    
    Args:
        input_text: Description of the parameter
    
    Returns:
        Dictionary with the result
    """
    return {"result": f"Processed: {input_text}"}
```

## Configuration



## Deployment


### Docker Deployment

This project includes a Dockerfile for easy deployment:

```bash
docker build -t ddg-mcp4 .
docker run -p 8080:8080 ddg-mcp4
```



### CI/CD

This project includes GitHub Actions workflows for:
- Running tests on multiple Python versions
- Building and testing Docker images
- Automated deployment (when configured)


## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Run the test suite
6. Create a pull request

## License

MIT License