DuckDuckGo搜索服务器

一个提供DuckDuckGo搜索功能的Model Context Protocol (MCP)服务器,支持网页搜索、结果摘要和异步处理。

  • by rsimd
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rsimd/duckduckgo-mcp-server

使用说明

该项目由AI代码编辑器“Cursor”创建。 Cursor使用的大型语言模型(LLM)是“GPT-4.1”。 详细规格记录在 规格.md.

DuckDuckGo MCP服务器

DuckDuckGo搜索功能Model Context Protocol (MCP) 服务器。

支持的应用程序

  • 克劳德桌面 -Mac/Windows/Linux
  • 光标IDE - AI安装代码编辑器
  • 其他MCP支持的应用程序

机能

  • DuckDuckGo中的Web页面搜索
  • 获取搜索结果摘要和详细信息
  • 快速异步搜索
  • 通过回退功能确保稳定性

前提条件

  • Python 3.11以降 (推奨:Python 3.13)
  • uv 包管理器(建议)或pip

安装,安装

uv (建议)

  1. 紫外线 安装:
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 安装项目相关性:
uv sync
  1. 启动服务器:
uv run duckduckgo-mcp-server
# または
python run.py

传统方法

  1. 安装相关性:
pip install -r requirements.txt
  1. 启动服务器:
python server.py

使用方法

这个MCP服务器提供以下工具:

  • search_duckduckgo: DuckDuckGo执行搜索

设定

不需要特殊设置。DuckDuckGo的,之API可以免费使用。

测试

uv 中所述修改相应参数的值

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

传统方法

python test_search.py

Docker 执行

Docker在环境中也可以执行(Python3.13+uv和pip):

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

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

# 停止
docker compose down

MCP 客户端使用

克劳德桌面

了解更多信息 CLAUDE_DESKTOP_SETUP.md 来修改标记元素的显示属性。

本地环境

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

光标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 Server利用期间 CONNECTION_SOLUTION.md 来修改标记元素的显示属性。

故障排除

如果出现问题,请参阅:

许可证

MIT许可证