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 | 布尔值 | false | 启用整页内容提取 |
max_content_length | 整数 | 50000 | 每页最大字符数（当 fetch_full_content 是真的） |
响应结构
当 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 .env2.所需代币
| 代币 | 目的 | 如何获得 |
|---|---|---|
| PyPI API令牌 | 发布到PyPI | 1。首选 PyPI帐户设置 |
2.选择“添加API令牌” 3.范围至“整个账户”（首次发布） 4.设置为 TWINE_PASSWORD 在 .env | | 代理URL |绕过块（可选）|如果遇到速率限制，请使用任何HTTP/SOCKS5代理提供程序。 |
开发/出版
要构建此包并将其发布到PyPI（使用上面的秘密）：
- 构建:
pip install build twine
python -m build- 发布 （如果导出机密，则从.env加载机密，或提示您）：
# If using .env variables (PowerShell)
# $env:TWINE_USERNAME = "__token__"
# $env:TWINE_PASSWORD = "pypi-..."
python -m twine upload dist/*