Google Search MCP Server

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. 在“凭据”部分生成 API 密钥，或按照 Custom Search 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
    # or
    npm install
   

3. 构建项目

    pnpm run build
    # or
    npm run build
   

4. 配置 Claude Desktop 更新你的 claude_desktop_config.json：

   {
     "mcpServers": {
       "google-search": {
         "command": "/path/to/node", // <--- Important to add the following, run in your terminal `echo "$(which node)"` to get the path
         "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 文件。