Google Search MCP 服务器

一个集成了 Google Custom Search JSON API 的 MCP 服务器实现，提供网络搜索功能。

功能

• 网络搜索: 使用全面的查询选项搜索 Google
• 高级过滤: 通过日期、语言、国家和安全搜索级别控制结果
• 速率限制: 内置速率限制，防止 API 配额耗尽
• 结构化结果: 返回格式化的搜索结果，包含标题、URL 和摘要

工具

• google_search
  • 使用高级过滤选项执行 Google 搜索
  • 输入:
    • query (字符串): 搜索词 (必需)
    • num_results (数字, 可选): 结果数量 (1-10, 默认: 5)
    • date_restrict (字符串, 可选): 按日期过滤 (例如, "d1" 表示最近一天)
    • language (字符串, 可选): 2 个字母的语言代码 (例如, "en")
    • country (字符串, 可选): 2 个字母的国家代码 (例如, "us")
    • safe_search (字符串, 可选): 安全级别 ("off", "medium", "high")

配置

获取 API 密钥

1. 在 Google Cloud Console 创建一个 Google Cloud 项目
2. 通过 API 仪表板 为您的项目激活 Custom Search JSON API
3. 通过凭据部分或按照 Custom Search API 指南 生成 API 密钥
4. 通过在 Google Programmable Search 中设置自定义搜索引擎来获取搜索引擎 ID

环境变量

在运行服务器之前设置这些变量：

export GOOGLE_API_KEY="your-api-key"
export GOOGLE_SEARCH_ENGINE_ID="your-search-engine-id"

从本地仓库运行

要直接从源代码运行服务器：

1. 克隆仓库

    git clone https://github.com/ayush-rudani/google-search-mcp-server.git
    cd google-search-mcp-server
   

2. 安装依赖

    pnpm install
    # 或
    npm install
   

3. 构建项目

    pnpm run build
    # 或
    npm run build
   

4. 配置 Claude Desktop 更新您的 claude_desktop_config.json:

   {
     "mcpServers": {
       "google-search": {
         "command": "/path/to/node", // <--- 重要的是添加以下内容，在您的终端中运行 `echo "$(which node)"` 以获取路径
         "args": ["/full/path/to/google-search-mcp/index.js"],
         "env": {
           "GOOGLE_API_KEY": "your-api-key",
           "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
         }
       }
     }
   }
   

   • 将 /path/to/node 替换为 Node.js 可执行文件的完整路径（您可以通过在终端中运行命令 which node 来找到它）

5. 测试服务器

    export GOOGLE_API_KEY=your_api_key_here
    export GOOGLE_SEARCH_ENGINE_ID=your_engine_id_here
    node dist/index.js
   

速率限制

默认情况下，服务器强制执行每分钟 10 个请求的速率限制，以防止超出 Google 的 API 配额。 如果需要，您可以在代码中调整此限制。

许可证

此 MCP 服务器在 MIT 许可证下获得许可。 有关详细信息，请参见 LICENSE 文件。