Uzair-math/MCP-Server-Claude

🦆 DuckDuckGo MCP Server

A lightweight Model Context Protocol (MCP) server that integrates with DuckDuckGo Search. This server exposes a tool (duckduckgo_search) that allows AI models (like Claude, ChatGPT, or any MCP client) to perform real-time web searches and return the top search results.

Demo: MCP.jpg

🚀 Features

🌐 Search DuckDuckGo directly from an MCP server.

🔎 Returns top results (title + link).

⚡ Built with FastMCP for fast and simple MCP server creation.

🛡️ Handles errors gracefully.

🧩 Easy to integrate with AI assistants like Claude Desktop.

📂 Project Structure duckduckgo-mcp-server/ │── server.py # Main MCP server code │── requirements.txt # Python dependencies │── README.md # Project documentation

🛠️ Installation

1. Clone the repo git clone https://github.com/your-username/duckduckgo-mcp-server.git cd duckduckgo-mcp-server

2. Create & activate virtual environment python -m venv .venv source .venv/bin/activate # On Linux/Mac .venv\Scripts\activate # On Windows

3. Install dependencies pip install -r requirements.txt

▶️ Usage

Run the MCP server:

python server.py

Expected output:

🚀 DuckDuckGo MCP Server running on port 10000

The server will now be available for MCP clients.

🔧 Exposed Tool duckduckgo_search

Search DuckDuckGo for a query and return results.

Arguments:

query (str) → The search query.

max_results (int, default=5) → Number of results to return.

Example Call (from an MCP client like Claude Desktop):

{ "tool": "duckduckgo_search", "arguments": { "query": "Pakistan news", "max_results": 5 } }

Example Response:

Dawn - Pakistan Latest News - https://www.dawn.com/ The Express Tribune - Pakistan News - https://tribune.com.pk/ Geo News Pakistan - Latest Updates - https://www.geo.tv/ ARY News - Pakistan Headlines - https://arynews.tv/ Samaa TV - Pakistan Top Stories - https://www.samaa.tv/

🧑‍💻 Development Add new tools

You can easily extend this MCP server with more tools. Example:

@mcp.tool() def hello(name: str) -> str: return f"Hello, {name}!"

📦 Requirements

Python 3.9+

FastMCP

httpx

beautifulsoup4

🤝 Contributing

Contributions are welcome!

Fork the repo

Create a feature branch

Submit a Pull Request 🚀

📜 License

This project is licensed under the MIT License.

You are free to use, modify, and distribute it.