ddg-mcp123

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:

   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt pip install -e .

Usage

Stdio Transport (for Claude Desktop, etc.)

HTTP Transport (for web integration)

Docker

Available Tools

• example_tool: Echo a message back

• get_server_info: Get information about this MCP server

Development

Running Tests

Adding New Tools

1. Create a new function in ddg_mcp123/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:

Configuration

Deployment

Docker Deployment

This project includes a Dockerfile for easy deployment:

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