DuckDuckGo MCP Server

This project was created by the AI code editor "Cursor". The large language model (LLM) used by Cursor is "GPT-4.1". Detailed specifications are documented in specifications.md.

DuckDuckGo MCP 服务

这是一个提供 DuckDuckGo 搜索功能的 Model Context Protocol (MCP) 服务。

支持的应用程序

• Claude Desktop - Mac/Windows/Linux
• Cursor IDE - AI 驱动的代码编辑器
• 其他支持 MCP 的应用程序

功能

• 使用 DuckDuckGo 搜索网页
• 获取搜索结果摘要和详细信息
• 通过异步处理实现快速搜索
• 通过回退功能确保稳定性

前提条件

• Python 3.11 或更高版本（推荐：Python 3.13）
• uv 包管理器（推荐）或 pip

设置

使用 uv（推荐）

1. 安装 uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装项目依赖项:

uv sync

3. 启动服务:

uv run duckduckgo-mcp-server
# または
python run.py

传统方法（pip）

1. 安装依赖项:

pip install -r requirements.txt

2. 启动服务:

python server.py

使用方法

此 MCP 服务提供以下工具:

• search_duckduckgo：使用 DuckDuckGo 执行搜索

配置

无需特殊配置。DuckDuckGo API 可免费使用。

测试

使用 uv

uv run test-search
# または
python run.py test

传统方法

python test_search.py

使用 Docker 运行

也可以在 Docker 环境中运行（支持 Python 3.13 + uv 和 pip）:

# ビルドと起動
docker compose up --build -d

# テスト実行
docker compose --profile testing up test-runner

# 停止
docker compose down

在 MCP 客户端中使用

Claude Desktop

详情请参阅 CLAUDE_DESKTOP_SETUP.md。

本地环境（uv）

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "uv",
      "args": ["run", "duckduckgo-mcp-server"],
      "cwd": "/path/to/duckduckgo-mcp-server",
      "env": {}
    }
  }
}

Cursor IDE

详情请参阅 CURSOR_SETUP.md。

项目设置（.cursor/mcp.json）

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "uv",
      "args": ["run", "duckduckgo-mcp-server"],
      "env": {}
    }
  }
}

全局设置（~/.cursor/mcp.json）

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "uv",
      "args": ["run", "duckduckgo-mcp-server"],
      "env": {}
    }
  }
}

在远程环境中使用

通过 SSH 使用远程服务上的 MCP 服务时，请参阅 CONNECTION_SOLUTION.md。

故障排除

如果遇到问题，请参阅以下文档：

• TROUBLESHOOTING.md - 常见问题及解决方法
• CONNECTION_SOLUTION.md - 远程连接问题的解决方法
• IMPORTANT_NOTES.md - 重要的配置要点

许可证

MIT 许可证