https://github.com/zhsama/duckduckgo-mpc-server
https://github.com/zhsama/duckduckgo-mpc-server
Last synced: 6 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/zhsama/duckduckgo-mpc-server
- Owner: zhsama
- License: mit
- Created: 2025-03-09T13:32:08.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-04T09:10:29.000Z (17 days ago)
- Last Synced: 2025-04-10T04:18:23.009Z (11 days ago)
- Language: TypeScript
- Size: 19.5 KB
- Stars: 23
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - DuckDuckGo MCP Search Server - Provides DuckDuckGo web search functionality via the Model Context Protocol (Table of Contents / Search)
- awesome-mcp-zh - zhsama/duckduckgo-mcp-server
README
# duckduckgo-search MCP Server
English | [中文](README_zh.md)
A Model Context Protocol server for DuckDuckGo Search
This is a TypeScript-based MCP server that provides DuckDuckGo search functionality. It demonstrates core MCP concepts through:
- Integration with DuckDuckGo Search
- Easy-to-use search tool interface
- Rate limiting and error handling support
## Features
### Search Tool
- `duckduckgo_search` - Perform web searches using DuckDuckGo API
- Required parameter: `query` (search query, max 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 Limits
- Maximum 1 request per second
- Maximum 15000 requests per month
## Development
### Prerequisites
- Node.js >= 18
- pnpm >= 8.0.0
### Installation
```bash
# Install pnpm if not already installed
npm install -g pnpm
# Install project dependencies
pnpm install
```
### Build and Run
Build the server:
```bash
pnpm run build
```
For development with auto-rebuild:
```bash
pnpm run watch
```
## Setup in Claude Desktop
To use with Claude Desktop, add the server config:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
```json
# online
{
"mcpServers": {
"duckduckgo-search": {
"command": "npx",
"args": [
"-y",
"duckduckgo-mcp-server"
]
}
}
}
# local
{
"mcpServers": {
"duckduckgo-search": {
"command": "node",
"args": [
"/path/to/duckduckgo-search/build/index.js"
]
}
}
}
```
### Debugging
Since 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:
```bash
pnpm run inspector
```
The Inspector will provide a URL to access debugging tools in your browser.