使用说明
🚀 带DuckDuckGo的MCP服务器(免费)
使用DuckDuckGo执行免费互联网搜索的MCP服务器——与 模型上下文协议(MCP) 生态系统,可与Claude Code、Claude Desktop、Cursor和任何支持MCP客户端的Claude工具一起使用 STDIO传输.
🚀 如何安装(所有方法)
✅ 方法1:克劳德代码(推荐-全局)
全局安装,使其在任何地方都可用:
claude mcp add duckduckgo -- npx -y duckduckgo-mcp-server
✅ 方法2:克劳德代码(项目范围)
仅为当前项目安装(保存在 .mcp.json):
claude mcp add duckduckgo -s project -- node /full/path/to/duckduckgo-mcp-server.js
✅ 方法3:克劳德桌面
🪟 视窗
路径:
%APPDATA%/Claude/claude_desktop_config.json
🍎 macOS/🐧 Linux
路径:
~/Library/Application Support/Claude/claude_desktop_config.json
添加:
{
"mcpServers": {
"duckduckgo": {
"command": "npx",
"args": ["-y", "duckduckgo-mcp-server"]
}
}
}
✅ 方法4:游标IDE
在光标中:
设置→ MCP服务器→ Add
- 姓名: 鸭鸭
- 类型: 命令
- 命令:
npx -y duckduckgo-mcp-server
🚀 替代方案:直接运行本地文件
如果您使用的是独立文件版本:
duckduckgo-mcp-server.js
✅ 方法5:直接节点(简单)
# First run auto-installs dependencies
node duckduckgo-mcp-server.js
✅ 方法6:可执行文件(Linux/Mac)
chmod +x duckduckgo-mcp-server.js
./duckduckgo-mcp-server.js
✅ 方法7:手动客户端配置(本地文件示例)
🪟 视窗
{
"mcpServers": {
"internet-search": {
"command": "node",
"args": ["C:\\Users\\YOUR_NAME\\Desktop\\duckduckgo-mcp-server.js"]
}
}
}
🍎 Mac/🐧 Linux
{
"mcpServers": {
"internet-search": {
"command": "node",
"args": ["/Users/your_name/Desktop/duckduckgo-mcp-server.js"]
}
}
}
🎯 改进包括
🔄 更新SDK
- 已升级到 MCP SDK v1.0.4
- 与MCP规范兼容 2025-06-18
🛠 改进的工具
| 工具 | 说明 |
|---|---|
web_search |
一般网络搜索 |
news_search |
带时间过滤的新闻搜索 |
search_images |
图片搜索 |
🛡 稳健的错误处理
- 所有日志都转到 标准错误 (stdout严格保留用于MCP协议)
- 面向用户的信息性错误消息
- 从不损坏MCP JSON流
⚙ 可靠的汽车安装
- 静默依赖安装(
--silent) - 2分钟超时保护
- 安装依赖关系后自动重新启动
- Windows兼容(
windowsHide: true)
🌍 通用兼容性
- 使用Claude Code
- 与Claude Desktop配合使用
- 使用游标
- 适用于任何支持STDIO的MCP客户端
- 优雅的关机处理(信号/信号)
✨ 是什么让它具有普遍性
| 特点 | 优点 |
|---|---|
| 单文件选项 | 复制、粘贴、工作 |
| npm包选项 | 几秒钟内全局安装 |
| 自动安装 | 无需手动设置npm |
| STDIO传输 | 与任何MCP客户端兼容 |
| 没有API密钥 | DuckDuckGo是免费和匿名的 |
| 稳健的错误处理 | 始终返回结构化响应 |
| 3个强大的工具 | 网络、新闻和图像搜索 |
🔧 需求
- 已安装Node.js(从下载 https://nodejs.org 如果需要)
- 互联网连接(用于搜索+首次安装)
💡 安装后如何使用
只要问:
- “在互联网上搜索最新的Node.js新闻”
- “查找有关MCP协议的文档”
- “搜索现代UI设计图片”
模型将自动调用:
web_searchnews_searchsearch_images