duckduckgo-search MCP服务器

英文 | 中文

这是一个为DuckDuckGo搜索提供的模型上下文协议(MCP)服务器。

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

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

功能

搜索工具

• 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

安装

# 如果尚未安装pnpm，请先安装
npm install -g pnpm

# 安装项目依赖
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

# 在线模式
{
  "mcpServers": {
    "duckduckgo-search": {
        "command": "npx",
        "args": [
          "-y",
          "duckduckgo-mcp-server"
        ]
    }
  }
}

# 本地模式
{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "node",
      "args": [
        "/path/to/duckduckgo-search/build/index.js"
      ]
    }
  }
}

调试

由于MCP服务器通过stdio通信，调试可能比较困难。我们推荐使用MCP Inspector，它作为包脚本提供：

pnpm run inspector

Inspector会提供一个URL，您可以在浏览器中访问调试工具。