MCP DuckDuckGo Search

A Model Context Protocol (MCP) server querying DuckDuckGo Instant Answer API.

Installation

Installing via Smithery

To install DuckDuckGo Search for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @shaheen2013/duckduckgo-search-mcp-server --client claude

Manual Installation

# Clone the repository
git clone https://github.com/shaheen2013/duckduckgo-search-mcp-server.git
cd duckduckgo-search-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Docker

You can test this MCP server using Docker. To do this first run:

docker build -t duckduckgo-search-mcp-server .
docker run -p 8080:8080 duckduckgo-search-mcp-server

You can then test the server running within Docker via the inspector e.g.

pnpm run inspector http://localhost:8080

Usage

Running the Server

You can use the MCP Inspector to test the server:

npm run inspector

Access the MCP Inspector and then test the tool e.g.

Development

Project Structure

• src/index.ts - Main server implementation

Available Scripts

• npm run build - Build the TypeScript code

• npm run watch - Watch for changes and rebuild

• npm run inspector - Run the MCP Inspector against the server

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

• Open Library API

• Model Context Protocol