DuckDuckGo MCP Server

DuckDuckGo MCP 服务

一个基于 Web 的搜索界面，使用 DuckDuckGo 的搜索 API，通过 Python 和 Gradio 构建。

Docker 设置

前提条件

• 系统已安装 Docker
• Git（可选，用于克隆仓库）

构建 Docker 镜像

1. 克隆仓库（如果尚未克隆）：

git clone <repository-url>
cd ddg_mcp_server

2. 构建 Docker 镜像：

docker build -t ddg-mcp-server .

运行容器

运行容器，并将端口 7860 映射到主机：

docker run -p 7860:7860 ddg-mcp-server

应用可通过以下地址访问：

• http://localhost:7860
• http://127.0.0.1:7860

故障排查

如果无法连接到应用：

1. 确认容器正在运行：

docker ps

2. 查看容器日志：

docker logs $(docker ps -q)

3. 尝试停止任何正在运行的容器，然后重新启动：

docker stop $(docker ps -q)
docker run -p 7860:7860 ddg-mcp-server

功能

• 基于 Web 的 DuckDuckGo 搜索界面
• 提供完整内容的实时搜索结果
• Markdown 格式的输出
• 可配置结果数量
• AI 驱动的内容摘要（详情请参阅 SUMMARIZATION.md）

开发

该应用使用以下技术构建：

• Python 3.10
• Gradio Web 界面
• DuckDuckGo 搜索 API
• BeautifulSoup4 网页抓取
• Markdownify 内容转换

摘要功能的 API 配置

此应用支持使用 OpenAI 的 API 或任何兼容的 API 服务生成内容摘要。启用此功能的步骤如下：

1. 将 .env.example 文件复制为 .env：

cp .env.example .env

2. 编辑 .env 文件并设置 API 凭据：

OPENAI_API_URL=https://api.openai.com/v1
ACCESS_TOKEN=your_api_key_here

注意：

• 如果未指定，OPENAI_API_URL 默认为官方 OpenAI API 服务端
• 摘要功能需要 ACCESS_TOKEN 才能运行
• 更改 OPENAI_API_URL 即可使用任何兼容 OpenAI 的 API

使用 Docker 和 API 凭据运行

使用 API 凭据运行 Docker 容器：

docker run -p 7860:7860 \
  -e OPENAI_API_URL="https://api.openai.com/v1" \
  -e ACCESS_TOKEN="your_api_key_here" \
  ddg-mcp-server

测试 API 连接

配置好 API 凭据后，可以测试连接是否正常：

python main.py --test-api

此操作会验证 API 凭据，但不会启动完整的服务端。

模型配置

可在 config.py 文件中配置用于生成摘要的 AI 模型：

# Default model to use for summarization
DEFAULT_MODEL = "gpt-4.1-turbo"

有关模型配置的详细说明，请参阅 SUMMARIZATION.md。