Web Search MCP Server 使用说明

项目简介

Web Search MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它提供了一个无需API密钥即可进行网页搜索的功能。该服务器通过抓取 Google 搜索引擎的结果,向 LLM 客户端提供结构化的搜索结果,使其能够便捷地获取网络信息。

主要功能点

  • 网页搜索: 允许 LLM 客户端通过关键词在互联网上进行搜索,获取相关信息。
  • 无需 API 密钥: 使用网络抓取技术,无需 Google Search API 密钥即可工作。
  • 结构化结果: 返回包含标题、URL 和描述的结构化搜索结果,方便 LLM 理解和使用。
  • 可配置结果数量: 允许客户端配置每次搜索返回的最大结果数量。

安装步骤

  1. 克隆仓库: 将 'web-search' 仓库克隆到本地。
    git clone https://github.com/pskill9/web-search.git
    cd web-search
  2. 安装依赖: 使用 npm 安装项目依赖。
    npm install
  3. 构建服务器: 构建 TypeScript 代码生成 JavaScript 文件。
    npm run build

服务器配置

要将 Web Search MCP Server 集成到 MCP 客户端(如 Claude Dev Extension 或 Claude Desktop),您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置。请根据您的实际路径修改 'command' 和 'args' 中的路径。

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
      // command: 启动服务器的命令,这里使用 node
      // args:   命令参数,指向构建后的 index.js 文件路径。请替换 "/path/to/web-search" 为您本地仓库的实际路径
    }
  }
}

基本使用方法

配置完成后,在支持 MCP 协议的 LLM 客户端中,您可以使用 'use_mcp_tool' 函数来调用 'web-search' 服务器提供的 'search' 工具。

调用 'search' 工具时,需要提供以下参数:

  • 'query': (必选) 搜索关键词,字符串类型。
  • 'limit': (可选) 返回结果的最大数量,数字类型,默认值为 5,最大值为 10。

示例:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "最新的科技新闻",
    limit: 5
  }
})

服务器将返回一个 JSON 格式的搜索结果数组,每个结果包含 'title', 'url', 和 'description' 字段。

[
  {
    "title": "搜索结果标题",
    "url": "搜索结果URL",
    "description": "搜索结果描述..."
  },
  // ... 更多搜索结果
]

请注意,由于该工具使用网页抓取技术,可能受到 Google 搜索的反爬虫机制限制,使用时请注意频率控制。

信息

分类

网页与API