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

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

Usage

Stdio Transport (for Claude Desktop, etc.)

ddg_mcp123-mcp --transport stdio

HTTP Transport (for web integration)

ddg_mcp123-mcp --transport streamable-http --port 8080

Docker

# Build image docker build -t ddg-mcp123 . # Run container docker run -p 8080:8080 ddg-mcp123

Available Tools

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

Development

Running Tests

pip install pytest pytest-asyncio pytest tests/

Adding New Tools

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

Example:

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

docker build -t ddg-mcp123 . docker run -p 8080:8080 ddg-mcp123

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

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Run the test suite
Create a pull request

License

MIT License

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

A basic MCP server built with FastMCP framework that provides example tools for echoing messages and retrieving server information. Supports both stdio and HTTP transports with Docker deployment capabilities.

DuckDuckGo MCP Server