duckduckgo-search MCP Server

1# duckduckgo-search MCP Server
2 
3English | [中文](README_zh.md)
4 
5A Model Context Protocol server for DuckDuckGo Search
6 
7This is a TypeScript-based MCP server that provides DuckDuckGo search functionality. It demonstrates core MCP concepts through:
8 
9- Integration with DuckDuckGo Search
10- Easy-to-use search tool interface
11- Rate limiting and error handling support
12 
13<a href="https://glama.ai/mcp/servers/34fhy9xb9w">
14  <img width="380" height="200" src="https://glama.ai/mcp/servers/34fhy9xb9w/badge" alt="DuckDuckGo Server MCP server" />
15</a>
16 
17## Features
18 
19### Search Tool
20 
21- `duckduckgo_search` - Perform web searches using DuckDuckGo API
22  - Required parameter: `query` (search query, max 400 characters)
23  - Optional parameter: `count` (number of results, 1-20, default 10)
24  - Optional parameter: `safeSearch` (safety level: strict/moderate/off, default moderate)
25  - Returns formatted Markdown search results
26 
27### Rate Limits
28 
29- Maximum 1 request per second
30- Maximum 15000 requests per month
31 
32## Development
33 
34### Prerequisites
35 
36- Node.js >= 18
37- pnpm >= 8.0.0
38 
39### Installation
40 
41```bash
42# Install pnpm if not already installed
43npm install -g pnpm
44 
45# Install project dependencies
46pnpm install
47```
48 
49### Build and Run
50 
51Build the server:
52 
53```bash
54pnpm run build
55```
56 
57For development with auto-rebuild:
58 
59```bash
60pnpm run watch
61```
62 
63## Setup in Claude Desktop
64 
65To use with Claude Desktop, add the server config:
66 
67On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
68On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
69 
70```json
71# online
72{
73  "mcpServers": {
74    "duckduckgo-search": {
75        "command": "npx",
76        "args": [
77          "-y",
78          "duckduckgo-mcp-server"
79        ]
80    }
81  }
82}
83 
84# local
85{
86  "mcpServers": {
87    "duckduckgo-search": {
88      "command": "node",
89      "args": [
90        "/path/to/duckduckgo-search/build/index.js"
91      ]
92    }
93  }
94}
95```
96![image](https://github.com/user-attachments/assets/6906e280-9dbb-4bb5-a537-d9e45e666084)
97![image](https://github.com/user-attachments/assets/867a70ae-082f-45ab-a623-869bfd6c31eb)
98 
99### Debugging
100 
101Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
102 
103```bash
104pnpm run inspector
105```
106 
107The Inspector will provide a URL to access debugging tools in your browser.