Google Custom Search

🚀 使用谷歌自定义搜索的MCP服务器

这是一个提供网页搜索功能的模型上下文协议（MCP）服务器，借助谷歌自定义搜索API和网页内容提取功能，为用户提供便捷的网页搜索与内容提取服务。

🚀 快速开始

设置

获取谷歌API密钥和搜索引擎ID

1. 创建谷歌云项目：
   • 访问谷歌云控制台。
   • 创建新项目或选择现有项目。
   • 开启项目计费。
2. 启用自定义搜索API：
   • 访问API库。
   • 搜索“Custom Search API”。
   • 点击“启用”。
3. 获取API密钥：
   • 访问凭证。
   • 点击“创建凭证”>“API密钥”。
   • 复制你的API密钥。
   • （可选）限制该密钥仅用于自定义搜索API。
4. 创建自定义搜索引擎：
   • 访问可编程搜索引擎。
   • 输入要搜索的站点（使用www.google.com进行全网搜索）。
   • 点击“创建”。
   • 在下一步中点击“自定义”。
   • 在设置中启用“搜索整个网络”。
   • 复制你的搜索引擎ID(cx)。

开发

安装依赖

npm install

构建服务器

npm run build

开发时自动重建

npm run watch

✨ 主要特性

搜索工具

使用谷歌自定义搜索API执行网页搜索：

• 可搜索整个网络或特定站点。
• 能控制结果数量（1 - 10）。
• 可获取结构化结果，包括标题、链接和摘录。

网页阅读器工具

提取任何网页内容：

• 抓取并解析网页内容。
• 提取页面标题和正文文本。
• 清理内容以去除脚本和样式。
• 返回结构化数据，包括标题、文本和URL。

📦 安装指南

通过Smithery安装

要自动通过Smithery安装适用于Claude桌面的谷歌自定义搜索服务器：

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

与Claude桌面一起使用时，添加包含你的谷歌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": "你的搜索查询",
    "num": 5 // 可选，默认为5，范围1-10
  }
}

网页阅读器工具

{
  "name": "extract",
  "arguments": {
    "url": "网页链接"
  }
}

示例响应

搜索工具

{
  "items": [
    {
      "title": "结果标题1",
      "link": "https://example.com/1",
      "snippet": "结果摘录1"
    },
    // 其他结果...
  ]
}

网页阅读器工具

{
  "title": "页面标题",
  "text": "页面正文内容..."
}

调试

使用DEBUG=mcp-google-search环境变量启用调试输出：

DEBUG=mcp-google-search npm start

⚠️ 重要提示

• 确保你拥有搜索目标站点的权限。
• 遵守谷歌API的服务条款和使用限制。