DuckDuckGo MCP Server

🚀 鸭鸭GO搜索MCP服务器

这是一个基于 TypeScript 的 MCP 服务器，它集成了鸭鸭 GO 搜索功能。该项目通过集成 DuckDuckGo 搜索、提供易用的搜索工具界面以及支持速率限制和错误处理等方面，生动地演示了 MCP 的核心概念。

🚀 快速开始

本服务器是基于 TypeScript 构建的 MCP 服务器，集成了鸭鸭 GO 搜索功能，你可以通过以下步骤快速开启使用。

✨ 主要特性

• 集成 DuckDuckGo 搜索：借助 DuckDuckGo API 实现网络搜索功能。
• 易用的搜索工具界面：提供便捷的搜索工具，方便用户进行操作。
• 支持速率限制和错误处理：确保服务的稳定性和可靠性。

搜索工具

• 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。