duckduckgo-search MCP Server

Name: duckduckgo-search MCP Server
Author: zhsama

本地服务

github.com/zhsama搜索与检索8782 周前更新

代码仓库

关于 duckduckgo-search MCP Server

duckduckgo-search MCP Server 是一个基于 TypeScript 的 MCP 服务，提供 DuckDuckGo 网页搜索功能。适合需要为 MCP 客户端添加简单搜索能力的开发者，并内置速率限制和错误处理。

主要功能

01duckduckgo_search 搜索工具
02可设置结果数量（1-20）
03安全搜索级别选择
04返回 Markdown 格式结果
05内置速率限制

适用场景

01让 Claude Desktop 在回答中查询网页信息
02为本地 MCP 客户端添加网页搜索能力
03调试 MCP 服务的 stdio 通信

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 duckduckgo_search 工具，客户端可通过 npx 方式在配置中启动它。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "duckduckgo-mcp-server-zhsama": {
      "command": "npx",
      "args": [
        "-y",
        "duckduckgo-mcp-server"
      ]
    }
  }
}

启动命令npx -y duckduckgo-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmduckduckgo-mcp-serverstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
query	string	是	搜索查询（最多 400 个字符）
count	number	否	结果数量（1-20，默认值为 10）
safeSearch	enum	否	SafeSearch 级别（strict、moderate、off）strict \| moderate \| off

详细介绍

duckduckgo-search MCP 服务

English | 中文

DuckDuckGo Search 的模型上下文协议服务

这是一个基于 TypeScript 的 MCP 服务，提供 DuckDuckGo 搜索功能。它通过以下内容展示 MCP 的核心概念：

与 DuckDuckGo Search 集成
易于使用的搜索工具接口
支持速率限制和错误处理

功能

搜索工具

duckduckgo_search - 使用 DuckDuckGo API 执行网页搜索
- 必需参数：query（搜索查询，最多 400 个字符）
- 可选参数：count（结果数量，1-20，默认值为 10）
- 可选参数：safeSearch（安全级别：strict/moderate/off，默认值为 moderate）
- 返回格式化的 Markdown 搜索结果

速率限制

每秒最多 1 个请求
每月最多 15000 个请求

开发

前置条件

Node.js >= 18
pnpm >= 8.0.0

安装

# Install pnpm if not already installed
npm install -g pnpm

# Install project dependencies
pnpm install

构建和运行

构建服务：

pnpm run build

在开发模式下自动重新构建：

pnpm run watch

在 Claude Desktop 中设置

要在 Claude Desktop 中使用，请添加服务配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.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"
      ]
    }
  }
}