mcp-duckduckgo-search

---

⚠️ 注意事项

此仓库不再维护。

该工具的功能现在可以在 mcp-omnisearch 中使用，它将多个MCP工具整合到一个统一的包中。

请改用 mcp-omnisearch。

---

这是一个用于集成DuckDuckGo搜索功能与LLMs的Model Context Protocol (MCP)服务器。此服务器提供了全面的网络搜索功能，并支持多种结果类型和过滤选项。

<a href="https://glama.ai/mcp/servers/v99lwtriyk"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=505829402,660174707&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

功能

• 🔍 使用DuckDuckGo搜索引擎进行全面的网络搜索
• 📊 丰富的结果类型包括：
  • 知识图谱信息
  • 自然搜索结果
  • 新闻文章
  • 视频内容
  • 图片结果
  • 相关搜索
• 🌍 地区特定搜索支持
• 🛡️ 可配置的安全搜索级别
• 📅 基于日期的过滤选项
• 📄 分页支持
• 💾 内置结果缓存
• 🔒 安全搜索选项（关闭、中等、严格）

配置

此服务器需要通过您的MCP客户端进行配置。以下是不同环境下的示例：

Cline配置

在您的Cline MCP设置中添加以下内容：

{
	"mcpServers": {
		"mcp-duckduckgo-search": {
			"command": "npx",
			"args": ["-y", "mcp-duckduckgo-search"],
			"env": {
				"SERPAPI_KEY": "your-serpapi-api-key"
			}
		}
	}
}

Claude Desktop与WSL配置

对于WSL环境，在您的Claude Desktop配置中添加以下内容：

{
	"mcpServers": {
		"mcp-duckduckgo-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && SERPAPI_KEY=your-serpapi-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-duckduckgo-search"
			]
		}
	}
}

环境变量

服务器需要以下环境变量：

• SERPAPI_KEY: 您的SerpAPI密钥（必需）

API

服务器实现了一个具有可配置参数的单一MCP工具：

ddg_search

使用DuckDuckGo搜索引擎执行网络搜索。

参数：

• query (字符串，必需): 搜索查询
• region (字符串，可选): 区域代码（例如，us-en, uk-en） （默认：us-en）
• safe_search (字符串，可选): 安全搜索级别（关闭、中等、严格） （默认：中等）
• date_filter (字符串，可选): 根据日期筛选结果：
  • 'd': 过去一天
  • 'w': 过去一周
  • 'm': 过去一个月
  • 'y': 过去一年
  • 自定义范围：'2023-01-01..2023-12-31'
• start (数字，可选): 结果偏移量以支持分页
• no_cache (布尔值，可选): 跳过缓存以获取最新结果 （默认：false）

响应包括：

• 当可用时的知识图谱数据
• 自然搜索结果
• 新闻文章
• 视频内容
• 图片结果
• 相关搜索
• 搜索元数据

开发

设置

1. 克隆仓库
2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm build

4. 在开发模式下运行：

pnpm dev

发布

该项目使用changesets进行版本管理。要发布：

1. 创建一个changeset：

pnpm changeset

2. 对包进行版本化：

pnpm changeset version

3. 发布到npm：

pnpm release

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT许可证 - 详情见LICENSE文件。

致谢

• 基于Model Context Protocol
• 通过SerpAPI由DuckDuckGo提供支持