使用说明

项目简介

duckduckgo-web-search MCP服务器是一个基于Model Context Protocol (MCP) 的后端服务，它通过集成DuckDuckGo搜索引擎，为LLM客户端提供实时的网络搜索能力。该服务器实现了一个名为 'duckduckgo_web_search' 的工具，允许LLM客户端向DuckDuckGo发送查询请求，并以结构化的Markdown格式返回搜索结果。

主要功能点

网络搜索工具: 提供 'duckduckgo_web_search' 工具，LLM客户端可以调用此工具执行网络搜索。
DuckDuckGo API 集成: 使用DuckDuckGo API进行搜索，返回高质量的搜索结果。
结构化输出: 搜索结果以Markdown格式返回，方便LLM理解和处理。
速率限制: 内置简单的速率限制机制，保护服务器资源。
易于集成: 可以通过简单的配置集成到支持MCP协议的LLM客户端，如 Claude Desktop。

安装步骤

克隆仓库: 将仓库 'https://github.com/Sunwood-ai-labs/duckduckgo-web-search' 克隆到本地。
安装依赖: 在仓库根目录下运行命令 'npm install' 安装项目依赖。
构建项目: 运行命令 'npm run build' 构建项目，生成可执行的服务器代码。

服务器配置

要将此MCP服务器配置到MCP客户端（例如 Claude Desktop），您需要编辑客户端的配置文件。以 Claude Desktop 为例，配置文件路径如下：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在配置文件中，找到 '"mcpServers"' 部分，并添加一个新的服务器配置项。配置信息如下：

{
  "mcpServers": {
    "duckduckgo-web-search": {
      "command": "/path/to/duckduckgo-web-search/build/index.js"
    }
  }
}

配置参数说明:

'"duckduckgo-web-search"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command"': 必须修改。指向服务器启动脚本的路径。请将 '/path/to/duckduckgo-web-search/build/index.js' 替换为 您本地仓库构建后 'index.js' 文件的绝对路径。例如，如果您的仓库克隆在 '~/Documents/duckduckgo-web-search' 目录下，则 'command' 应配置为 '"/Users/your_username/Documents/duckduckgo-web-search/build/index.js"' (MacOS) 或 '"C:\Users\YourUsername\Documents\duckduckgo-web-search\build\index.js"' (Windows)。

注意: 请确保配置文件的 JSON 格式正确，避免语法错误。

基本使用方法

启动服务器: 配置完成后，MCP服务器将会在客户端启动时自动运行。无需手动启动服务器，它会作为客户端的后台进程运行。
在LLM客户端中使用: 在支持MCP协议的LLM客户端中（如 Claude Desktop），您可以指示LLM使用 'duckduckgo_web_search' 工具进行网络搜索。例如，您可以向LLM发送指令：
```
请使用 duckduckgo_web_search 工具搜索 "最新的AI技术发展"。
```
LLM客户端会将此请求转发到 duckduckgo-web-search MCP服务器，服务器执行搜索并将结果返回给LLM客户端，最终LLM会将搜索结果整合到回复中。

工具调用示例 (在LLM指令中):

'duckduckgo_web_search query="今天的天气"'
'duckduckgo_web_search query="最新疫情数据" count=5' (指定返回5条结果，默认为10条，最大20条)

请根据您的LLM客户端的具体使用方式来调用 'duckduckgo_web_search' 工具。

关键词