使用说明

项目简介

本项目 'mcp-google-search' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供网络搜索和网页内容读取能力。它通过 Google Custom Search API 实现强大的搜索功能，并能提取网页的文本内容，从而扩展 LLM 的知识范围和信息获取能力。

主要功能点

网络搜索工具 (search): 利用 Google Custom Search API 执行网络搜索，可以指定关键词进行全网或特定网站的搜索，并返回结构化的搜索结果，包括标题、链接和摘要。
网页内容读取工具 (read_webpage): 能够抓取并提取指定URL网页的正文内容，去除HTML标签和脚本，返回干净的文本信息，以及网页标题和原始URL。

安装步骤

获取 Google API 密钥和搜索引擎 ID: 请按照仓库 README.md 文件中的 "Setup" 部分指引，完成 Google Cloud 项目创建、Custom Search API 启用、API 密钥创建以及自定义搜索引擎 ID 的获取。这些凭据是服务器运行的必要条件。
安装依赖: 在本地克隆或下载仓库代码后，打开终端，进入项目根目录，运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以 Claude Desktop 客户端为例，您需要编辑配置文件 'claude_desktop_config.json'，添加以下服务器配置信息。

配置文件路径：

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

配置信息 (JSON 格式):

{
  "mcpServers": {
    "google-search": {  // 服务器名称，客户端使用时需要引用
      "command": "npx",  // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": [
        "-y",
        "@adenot/mcp-google-search" //  服务器 npm 包名，npx 会自动下载并运行
      ],
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",  //  替换为您的 Google API 密钥
        "GOOGLE_SEARCH_ENGINE_ID": "YOUR_SEARCH_ENGINE_ID" // 替换为您的 Google 搜索引擎 ID
      }
    }
  }
}

请务必将 'YOUR_GOOGLE_API_KEY' 和 'YOUR_SEARCH_ENGINE_ID' 替换为您在 Google Cloud Console 中获取的真实密钥和 ID。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以使用以下工具来扩展模型的能力。

1. 使用 'search' 工具进行网络搜索

向 MCP 服务器发送以下 JSON 请求，即可进行网络搜索。

{
  "name": "search",
  "arguments": {
    "query": "你的搜索关键词",  //  替换为您要搜索的关键词
    "num": 3  // 可选参数，指定返回搜索结果的数量 (1-10)，默认为 5
  }
}

2. 使用 'read_webpage' 工具读取网页内容

向 MCP 服务器发送以下 JSON 请求，即可读取指定网页的内容。

{
  "name": "read_webpage",
  "arguments": {
    "url": "https://example.com"  //  替换为您要读取的网页 URL
  }
}

服务器将返回包含搜索结果或网页内容的 JSON 响应，LLM 客户端可以解析这些信息并用于后续的对话或任务。