Ddgs MCP Server

DDGS MCP服务器

一个模型上下文协议（MCP）服务器，为AI代理提供DuckDuckGo搜索功能。

特性

• 搜索文本：使用高级元搜索 bing, brave, duckduckgo, google, mojeek, yahoo, yandex, wikipedia.

- 完整内容提取：可选择获取完整的页面内容（而不仅仅是片段）以获取全面的上下文。

• 搜索_新闻：查找最新更新、发布和技术新闻。

完整内容提取

对于需要从搜索结果中获取完整上下文的编码代理，请启用整页内容获取：

用法

{
  "query": "python async programming tutorial",
  "fetch_full_content": true,
  "max_content_length": 50000,
  "max_results": 5
}

参数

响应结构

当 fetch_full_content 启用后，每个结果都包括 full_content 字段：

[
  {
    "title": "Python Async Programming Guide",
    "href": "https://example.com/python-async",
    "body": "Brief snippet from search results...",
    "full_content": "Complete extracted article text with all paragraphs, code examples, and detailed explanations..."
  }
]

业绩说明

• 内容提取每页增加约1-3秒的延迟
• 最多可同时提取5页，以最大限度地减少总时间
• 取回返回失败 [Content extraction failed or blocked] 在不中断搜索的情况下
• 用途 编织 用于高质量的文本提取

安装与使用

您可以直接使用以下命令运行此服务器 uvx 无需在全球范围内安装。

VS代码（克劳德桌面/Cline）

将其添加到您的MCP设置文件中（例如。， cline_mcp_settings.json 或 claude_desktop_config.json):

{
  "mcpServers": {
    "ddgs-search": {
      "command": "uvx",
      "args": [
        "ddgs-mcp-server"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

手动执行

uvx ddgs-mcp-server

秘密和配置

本项目技术 不需要API密钥 在本地运行时，它会刮伤DuckDuckGo。然而，对于 出版 或 代理使用，您应该配置您的环境。

1.设置秘密

复制示例文件：

cp .env.example .env

2.所需代币

2.选择“添加API令牌” 3.范围至“整个账户”（首次发布） 4.设置为 TWINE_PASSWORD 在 .env | | 代理URL |绕过块（可选）|如果遇到速率限制，请使用任何HTTP/SOCKS5代理提供程序。 |

开发/出版

要构建此包并将其发布到PyPI（使用上面的秘密）：

1. 构建:

   pip install build twine
   python -m build

1. 发布 （如果导出机密，则从.env加载机密，或提示您）：

   # If using .env variables (PowerShell)
   # $env:TWINE_USERNAME = "__token__"
   # $env:TWINE_PASSWORD = "pypi-..."

   python -m twine upload dist/*