项目简介

这是一个基于 TypeScript 开发的 MCP 服务器,旨在为 LLM 应用提供 DuckDuckGo 网页搜索能力。通过集成此服务器,LLM 客户端可以调用 DuckDuckGo 搜索引擎获取最新的网络信息,从而增强 LLM 的知识面和信息处理能力。

主要功能点

  • 网页搜索工具: 提供 'duckduckgo_web_search' 工具,允许 LLM 客户端通过发送关键词查询 DuckDuckGo 搜索引擎。
  • 结果返回: 返回结构化的搜索结果,包括标题、描述和原文链接,方便 LLM 理解和利用搜索信息。
  • 速率限制: 内置简单的速率限制机制,以避免对 DuckDuckGo API 的滥用。

安装步骤

  1. 安装 Node.js 和 npm: 确保您的计算机上已安装 Node.js 和 npm (Node 包管理器)。
  2. 下载代码: 从 GitHub 仓库 https://github.com/MCP-Mirror/Sunwood-ai-labs_duckduckgo-web-search 克隆或下载代码到本地。
  3. 安装依赖: 打开终端,导航到代码仓库根目录,并运行命令 'npm install' 安装项目依赖。
  4. 构建项目: 运行命令 'npm run build' 构建服务器代码,构建后的文件将位于 'build' 目录中。

服务器配置

要将此 MCP 服务器与 MCP 客户端(例如 Claude Desktop)连接,您需要在客户端的配置文件中添加服务器配置。配置信息为 JSON 格式,示例如下。请务必将 'command' 字段的值替换为 'duckduckgo-web-search/build/index.js' 文件的绝对路径

{
  "mcpServers": {
    "duckduckgo-web-search": {
      "command": "/path/to/duckduckgo-web-search/build/index.js" // 请替换为 duckduckgo-web-search/build/index.js 文件的绝对路径
    }
  }
}

配置说明:

  • 'server name': 'duckduckgo-web-search' - 服务器的名称,客户端用此名称识别服务器。
  • 'command': '/path/to/duckduckgo-web-search/build/index.js' - 必须修改。指向服务器启动脚本 'index.js' 的绝对路径。例如,如果您的仓库位于 '/Users/yourname/Documents/duckduckgo-web-search',则 'command' 应设置为 '/Users/yourname/Documents/duckduckgo-web-search/build/index.js'。

基本使用方法

  1. 启动服务器: 打开终端,导航到代码仓库的根目录,运行命令 'node build/index.js' 启动 MCP 服务器。服务器成功启动后,会在终端输出 "DuckDuckGo Search MCP Server running on stdio"。
  2. 配置客户端: 根据 MCP 客户端(如 Claude Desktop)的文档,配置并连接到此 MCP 服务器。您需要提供上面生成的服务器配置 JSON。
  3. 调用工具: 在 LLM 对话中,您可以使用 '@tool_code duckduckgo_web_search' 命令来调用网页搜索工具,并使用 'query' 参数指定搜索关键词。例如,要搜索 "最新人工智能进展",可以在对话中输入:'@tool_code duckduckgo_web_search(query="最新人工智能进展")'。客户端会将此请求发送到 MCP 服务器,服务器执行搜索并将结果返回给 LLM。

信息

分类

网页与API