google-search-mcp-server

google-search-mcp-server

一个 ModelContextProtocol（MCP）服务，可将 Google 搜索功能作为工具提供。它会抓取 Google 搜索结果，并返回包含标题、URL 和摘要的结构化数据。

概览

google-search-mcp-server 实现了一个 MCP 服务，提供单个工具 google_search。该工具接受搜索查询，并以兼容 JSON 的格式返回搜索结果。它支持分页、可配置语言、安全搜索、结果数量限制，并使用随机用户代理来减少被检测为抓取行为的可能性。

主要功能：

• 通过 HTTP 请求抓取 Google 搜索结果
• 输出包含标题、URL 和摘要的结构化 JSON 数据
• 支持分页、结果数量限制以及语言／国家选项
• “手气不错”单结果模式
• 内置 Cookie jar，并在每次搜索时使用随机用户代理

安装

要求：

• Node.js v16 或更高版本
• 使用 pnpm 或 bun 进行包管理

克隆并安装依赖项：

git clone https://github.com/yourusername/google-search-mcp-server.git
cd google-search-mcp-server
pnpm install
# or
bun install

用法

启动 MCP 服务

启动服务。它会通过标准输入／输出监听 JSON-RPC 请求：

npm start

启动后，你将看到：

Google Search MCP Server running on stdio

与服务交互

使用任何 JSON-RPC 2.0 客户端（例如 jq、自定义脚本）列出工具并调用 google_search 工具。

列出可用工具：

echo '{"jsonrpc":"2.0","method":"ListTools","params":{},"id":1}' | npm start

调用 google_search 工具：

echo '{"jsonrpc":"2.0","method":"CallTool","params":{"name":"google_search","arguments":{"query":"OpenAI","num":5}},"id":2}' | npm start

示例响应：

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"results\":[...JSON string of search results...]}"
      }
    ],
    "isError": false
  }
}

Playground

如需在不使用 MCP 协议的情况下进行本地试验，请使用提供的 playground.ts 脚本：

npx esno src/playground.ts

该脚本会运行示例搜索，并将结果记录到控制台。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。