mcp-google-server：用于 Google 自定义搜索和网页阅读的 MCP 服务器

一个模型上下文协议 (Model Context Protocol, MCP) 服务器，它使用 Google 自定义搜索 API 提供网络搜索功能，并提供网页内容提取功能。

设置

获取 Google API 密钥和搜索引擎 ID

1. 创建一个 Google Cloud 项目：

   • 前往 Google Cloud Console
   • 创建一个新项目或选择一个现有项目
   • 为您的项目启用结算功能

2. 启用 Custom Search API：

   • 前往 API 库
   • 搜索 "Custom Search API"
   • 点击 "启用"

3. 获取 API 密钥：

   • 前往 凭据
   • 点击 "创建凭据" > "API 密钥"
   • 复制您的 API 密钥
   • (可选) 将 API 密钥限制为仅 Custom Search API

4. 创建自定义搜索引擎：

   • 前往 可编程搜索引擎
   • 输入您要搜索的网站（使用 www.google.com 进行常规网络搜索）
   • 点击 "创建"
   • 在下一页上，点击 "自定义"
   • 在设置中，启用 "搜索整个网络"
   • 复制您的搜索引擎 ID (cx)

开发

安装依赖项：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run watch

功能

搜索工具

使用 Google 自定义搜索 API 执行网络搜索：

• 搜索整个网络或特定网站
• 控制结果数量 (1-10)
• 获取包含标题、链接和摘要的结构化结果

网页阅读器工具

从任何网页提取内容：

• 获取并解析网页内容
• 提取页面标题和主要文本
• 通过删除脚本和样式来清理内容
• 返回包含标题、文本和 URL 的结构化数据

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Google Custom Search Server：

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

要与 Claude Desktop 一起使用，请添加包含您的 Google API 凭据的服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@adenot/mcp-google-search"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
      }
    }
  }
}

用法

搜索工具

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num": 5  // optional, default is 5, max is 10
  }
}

网页阅读器工具

{
  "name": "read_webpage",
  "arguments": {
    "url": "https://example.com"
  }
}

来自网页阅读器的示例响应：

{
  "title": "Example Domain",
  "text": "Extracted and cleaned webpage content...",
  "url": "https://example.com"
}

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。