ddg_mcp_server

# DuckDuckGo MCP Server A web-based search interface using DuckDuckGo's search API, built with Python and Gradio. ## Docker Setup ### Prerequisites - Docker installed on your system - Git (optional, for cloning the repository) ### Building the Docker Image 1. Clone the repository (if you haven't already): ```bash git clone <repository-url> cd ddg_mcp_server ``` 2. Build the Docker image: ```bash docker build -t ddg-mcp-server . ``` ### Running the Container Run the container with port 7860 mapped to your host: ```bash docker run -p 7860:7860 ddg-mcp-server ``` The application will be available at: - [http://localhost:7860](http://localhost:7860) - [http://127.0.0.1:7860](http://127.0.0.1:7860) ### Troubleshooting If you cannot connect to the application: 1. Verify the container is running: ```bash docker ps ``` 2. Check the container logs: ```bash docker logs $(docker ps -q) ``` 3. Try stopping any existing containers and starting fresh: ```bash docker stop $(docker ps -q) docker run -p 7860:7860 ddg-mcp-server ``` ## Features - Web-based search interface using DuckDuckGo - Real-time search results with full content - Markdown-formatted output - Configurable number of results ## Development The application is built with: - Python 3.10 - Gradio for the web interface - DuckDuckGo Search API - BeautifulSoup4 for web scraping - Markdownify for content conversion