Back to MCP directory
publicPublicdnsLocal runtime

ddg-mcp

DuckDuckGo搜索API服务,通过MCP协议提供多种搜索功能

article

README

🚀 项目文档

本项目提供了一系列搜索和聊天工具,可进行文本、图片、新闻、视频搜索以及AI聊天,支持多种搜索条件设置和多种AI模型,为用户提供便捷的信息获取和交互体验。

🚀 快速开始

启动服务

使用 uv 运行:

uv run ddg-mcp

或者手动运行:

python main.py

✨ 主要特性

  • 文本搜索:通过 ddg-text-search 工具进行关键词查询。
  • 图片搜索:利用 ddg-image-search 找寻相关图片。
  • 新闻搜索:使用 ddg-news-search 获取最新资讯。
  • 视频搜索:借助 ddg-video-search 查找视频内容。
  • AI 聊天:通过 ddg-ai-chat 实现智能对话,支持多种模型。

📦 安装指南

使用 uv 进行安装

uv get ddg-mcp

手动安装

  1. 克隆仓库:
git clone https://github.com/yourusername/ddg-mcp.git
cd ddg-mcp
  1. 安装依赖:
pip install -r requirements.txt

💻 使用示例

基础用法

文本搜索

使用 ddg-text-search 工具搜索 "气候变化解决方案"

图片搜索

使用 ddg-image-search 工具查找 "可再生能源" 的图片,颜色设为 "绿色"

新闻搜索

使用 ddg-news-search 工具查找关于 "人工智能" 的 recent新闻

视频搜索

使用 ddg-video-search 工具查找关于 "机器学习教程" 的视频,时长设为 "medium"

高级用法

文本搜索

使用 ddg-text-search 工具搜索 "可再生能源 filetype:pdf site:edu",设置区域为 "us-en",安全搜索为 "off",时间限制为 "y",结果数量设为 20

图片搜索

使用 ddg-image-search 工具搜索 "山脉风景",设置尺寸为 "Large",颜色为 "蓝色",图片类型为 "photo",布局为 "Wide",许可协议为 "Public"

新闻搜索

使用 ddg-news-search 工具搜索 "太空探索",设置区域为 "uk-en",时间限制为 "w",结果数量设为 15

视频搜索

使用 ddg-video-search 工具搜索 "烹饪食谱",设置分辨率
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client