DuckDuckGo MCP 服务器

这是一个基于网络的搜索界面，使用了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

特性

• 使用DuckDuckGo的基于网络的搜索界面
• 实时搜索结果，包含全文内容
• Markdown格式输出
• 可配置的结果数量
• 基于AI的内容摘要功能（详情见SUMMARIZATION.md）

开发

该应用使用以下工具构建：

• Python 3.10
• Gradio作为网页界面
• 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凭证而无需启动整个服务器。

模型配置

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

# 默认使用的摘要模型
DEFAULT_MODEL = "gpt-4.1-turbo"

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