Purpose
duckduckgo-mpc-server is a TypeScript-based Model Context Protocol (MCP) server that provides a functional interface for DuckDuckGo search. It demonstrates core MCP concepts and is mainly used to give MCP-enabled clients (such as Claude Desktop) web search capabilities.
Main Capabilities
- Integrates DuckDuckGo search.
- Provides an easy-to-use search tool interface.
- Supports rate limiting and error handling.
Search Tool
Tool name: duckduckgo_search, uses the DuckDuckGo API to perform web searches.
Parameters:
- Required parameter: query (search query, up to 400 characters).
- Optional parameter: count (number of results, 1-20, default 10).
- Optional parameter: safeSearch (safety level: strict/moderate/off, default moderate).
- Returns: formatted Markdown search results.
Rate Limiting
- At most 1 request per second.
- At most 15000 requests per month.
Build and Development
Build the server (the specific build command content is not explicitly given in the materials).
During development, automatic rebuild mode can be used (the specific command is not explicitly given in the materials).
Setting Up in Claude Desktop
To use it in Claude Desktop, add the server configuration:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
Because MCP servers communicate via stdio, debugging can be difficult. It is recommended to use MCP Inspector, which is provided as a package script. Inspector will provide a URL for accessing the debugging tool in a browser.
Applicable Scenarios and Limitations
Suitable for scenarios that require DuckDuckGo web search in an MCP client. In terms of limitations: a single query can be up to 400 characters; the number of results is 1-20; subject to the rate limits above. Other platform support, fees, and pricing information are not yet provided.
