内容
# 🚀 MCP 服务器与 DuckDuckGo (免费)
一个使用 DuckDuckGo 进行免费互联网搜索的 MCP 服务器 — 完全兼容 **模型上下文协议 (MCP)** 生态系统，并可与 Claude Code、Claude Desktop、Cursor 等 Claude 工具以及任何支持 **STDIO 传输** 的 MCP 客户端一起使用。
---
# 🚀 安装方法 (所有方法)
## ✅ 方法 1：Claude Code (推荐 - 全局)
全局安装，以便在任何地方都可用：
```bash
claude mcp add duckduckgo -- npx -y duckduckgo-mcp-server
```
---
## ✅ 方法 2：Claude Code (项目范围)
仅为当前项目安装（保存在 `.mcp.json` 中）：
```bash
claude mcp add duckduckgo -s project -- node /full/path/to/duckduckgo-mcp-server.js
```
---
## ✅ 方法 3：Claude Desktop
### 🪟 Windows
路径：
```
%APPDATA%/Claude/claude_desktop_config.json
```
### 🍎 macOS / 🐧 Linux
路径：
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
添加：
```json
{
"mcpServers": {
"duckduckgo": {
"command": "npx",
"args": ["-y", "duckduckgo-mcp-server"]
}
}
}
```
---
## ✅ 方法 4：Cursor IDE
在 Cursor 中：
**设置 → MCP 服务器 → 添加**
* **名称：** duckduckgo
* **类型：** 命令
* **命令：**
```bash
npx -y duckduckgo-mcp-server
```
---
# 🚀 替代方法：直接运行本地文件
如果您使用的是独立文件版本：
```
duckduckgo-mcp-server.js
```
---
## ✅ 方法 5：直接 Node (简单)
```bash
# 首次运行自动安装依赖
node duckduckgo-mcp-server.js
```
---
## ✅ 方法 6：可执行文件 (Linux/Mac)
```bash
chmod +x duckduckgo-mcp-server.js
./duckduckgo-mcp-server.js
```
---
## ✅ 方法 7：手动客户端配置 (本地文件示例)
### 🪟 Windows
```json
{
"mcpServers": {
"internet-search": {
"command": "node",
"args": ["C:\\Users\\YOUR_NAME\\Desktop\\duckduckgo-mcp-server.js"]
}
}
}
```
### 🍎 Mac / 🐧 Linux
```json
{
"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` | 图片搜索 |
---
## 🛡 强大的错误处理
* 所有日志都输出到 **stderr**（stdout 严格保留用于 MCP 协议）
* 提供信息丰富的用户错误消息
* 绝不会损坏 MCP JSON 流
---
## ⚙ 可靠的自动安装
* 静默依赖安装 (`--silent`)
* 2 分钟超时保护
* 依赖安装后自动重启
* Windows 兼容 (`windowsHide: true`)
---
## 🌍 通用兼容性
* 与 Claude Code 兼容
* 与 Claude Desktop 兼容
* 与 Cursor 兼容
* 与任何支持 STDIO 的 MCP 客户端兼容
* 优雅的关闭处理（SIGINT / SIGTERM）
---
# ✨ 使其通用的原因
| 功能 | 益处 |
| --------------------- | ----------------------------------- |
| 单文件选项 | 复制，粘贴，即可工作 |
| npm 包选项 | 几秒钟内全局安装 |
| 自动安装 | 无需手动 npm 设置 |
| STDIO 传输 | 与任何 MCP 客户端兼容 |
| 无 API 密钥 | DuckDuckGo 免费且匿名 |
| 强大的错误处理 | 始终返回结构化响应 |
| 3 个强大的工具 | 网络，新闻和图片搜索 |
---
# 🔧 要求
* 已安装 Node.js（如果需要，请从 [https://nodejs.org](https://nodejs.org) 下载）
* 互联网连接（用于搜索 + 首次安装）
---
# 💡 安装后如何使用
直接询问：
* “搜索最新的 Node.js 新闻”
* “查找有关 MCP 协议的文档”
* “搜索现代 UI 设计的图片”
模型将自动调用：
* `web_search`
* `news_search`
* `search_images`
## 由 MattimaxForce 制作
</div>
