使用说明
该项目由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 (建议)
- 紫外线 安装:
curl -LsSf https://astral.sh/uv/install.sh | sh
- 安装项目相关性:
uv sync
- 启动服务器:
uv run duckduckgo-mcp-server
# または
python run.py
传统方法
- 安装相关性:
pip install -r requirements.txt
- 启动服务器:
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 来修改标记元素的显示属性。
故障排除
如果出现问题,请参阅:
TROUBLESHOOTING.md-常见问题和解决方法CONNECTION_SOLUTION.md-如何解决远程连接问题IMPORTANT_NOTES.md-关键设置点
许可证
MIT许可证