Duckduckgo MCP Server

🚀 鴨鴨GO搜索 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，為用戶提供鴨鴨 GO 搜索功能。它通過集成 DuckDuckGo 搜索、打造易用的搜索工具界面以及支持速率限制和錯誤處理等方面，生動演示了 MCP 的核心概念。

🚀 快速開始

本服務器可提供鴨鴨 GO 搜索功能，下面為你介紹使用前的準備工作。

✨ 主要特性

搜索工具

• duckduckgo_search - 藉助 DuckDuckGo API 開展網絡搜索。
  • 必填參數：query（搜索查詢，最多 400 字符）
  • 可選參數：count（結果數量，範圍 1 - 20，默認值為 10）
  • 可選參數：safeSearch（安全性等級：嚴格/寬鬆/關閉，默認值為寬鬆）
  • 返回格式化的 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。