MCP Google Search

🚀 谷歌搜索的模型上下文协议服务器

本项目是一个提供网络搜索功能的 Model Context Protocol 服务器，借助 Google Custom Search API 和网页内容提取功能，为用户提供便捷的网络搜索及网页内容获取服务。

🚀 快速开始

本服务器可实现网络搜索和网页内容提取两大核心功能，以下为你详细介绍。

✨ 主要特性

搜索

利用 Google Custom Search API 开展网络搜索，具备以下优势：

• 可搜索整个互联网，也能针对特定网站进行精准搜索。
• 能够灵活控制搜索结果数量，范围为 1 - 10 条。
• 获取的搜索结果为结构化数据，涵盖标题、链接和摘录等关键信息。

网页阅读器

可从任意网页提取所需内容，具体功能如下：

• 自动抓取并解析网页内容。
• 精准提取页面标题和正文文本。
• 对网页内容进行清理，去除脚本和样式等干扰信息。
• 返回结构化数据，包含标题、文本和 URL 等内容。

📦 安装指南

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

1. 创建 Google Cloud 项目：
   • 访问 Google Cloud Console。
   • 可选择创建新项目或使用现有项目。
   • 务必启用项目的计费功能。
2. 启用 Custom Search API：
   • 访问 API 库。
   • 在搜索框中输入 "Custom Search API"。
   • 点击 "启用" 按钮。
3. 获取 API 密钥：
   • 访问 凭证。
   • 点击 "创建凭证" > "API Key"。
   • 复制生成的 API 密钥。
   • （可选）为增强安全性，可将密钥限制为仅用于 Custom Search API。
4. 创建 Custom Search 引擎：
   • 访问 Programmable Search Engine。
   • 输入要搜索的网站，若需全网搜索，可使用 www.google.com。
   • 点击 "创建" 按钮。
   • 在下一步中，点击 "自定义"。
   • 在设置中启用 "搜索整个互联网" 选项。
   • 复制生成的 Search Engine ID（cx）。

客户端配置

若要在 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", "@mcp-for-dev/mcp-google-search"],
      "env": {
        "GOOGLE_API_KEY": "你的 API 密钥",
        "GOOGLE_SEARCH_ENGINE_ID": "你的搜索引擎 ID"
      }
    }
  }
}