My Google Search MCP

我的谷歌搜索MCP

真正的谷歌搜索人工智能代理，由您自己的Chrome会话提供支持

](https://www.npmjs.com/package/my-google-search-mcp)   ](https://github.com/dev-tahir/my-google-search-mcp)

______________________________________________________________________

这是什么

my-google-search-mcp 是一个模型上下文协议服务器，为AI客户端提供了两个有用的工具：

• google_search 通过您的Chrome浏览器查看真实的谷歌结果
• fetch_and_filter 只提取网页的有用部分

该项目通过轻量级扩展程序使用您的真实Chrome会话，而不是使用抓取技巧来对抗机器人检测。

为什么它有用

快速开始

使用 google_search，您需要Chrome扩展程序和MCP服务器配置。

需求

• Node.js和npm
• 谷歌浏览器
• MCP兼容客户端
• 捆绑的Chrome扩展程序来自 chrome-extension/

可选：

• OPENROUTER_API_KEY 如果你想更严格地过滤 fetch_and_filter

1.安装Chrome扩展程序

1. 从下载项目 或克隆此仓库
2. 打开 chrome://extensions
3. 打开 开发者模式
4. 点击 装载时未包装
5. 选择 chrome-extension/ 文件夹

2.将MCP服务器添加到您的客户端

{
  "mcpServers": {
    "my-google-search-mcp": {
      "command": "npx",
      "args": ["-y", "my-google-search-mcp"]
    }
  }
}

你不需要先安装npm包。 npx 将自动下载并运行它。

3.启动服务器一次

运行：

npx my-google-search-mcp

首次运行时，CLI将：

• 启动本地MCP服务器
• 启动当地桥梁 127.0.0.1:3777
• 生成桥接令牌
• 将该令牌保存到 ~/.mcp-google-search.json
• 为您打印令牌

4.将令牌放入扩展中

打开 chrome-extension/background.js 并更新：

const BRIDGE_TOKEN = "your-token-here";

然后在中重新加载扩展 chrome://extensions.

5.使用它

设置后：

• 如果需要，重新启动MCP客户端
• 保持Chrome打开
• 使用 google_search 来自您的AI客户端

这是完整的设置。

运作原理

搜索流程

+-----------+
| AI Client |
+-----------+
      |
      v
+----------------------+
| my-google-search-mcp |
+----------------------+
      |
      v
+--------------+
| Local Bridge |
+--------------+
      |
      v
+------------------+
| Chrome Extension |
+------------------+
      |
      v
+---------------+
| Google Search |
+---------------+

页面提取流程

URL
  |
  v
Fetch page
  |
  v
Clean HTML -> Markdown
  |
  v
Optional LLM filtering

工具

google_search

搜索谷歌并返回结构化Markdown，其中可能包括：

• AI概览
• 精选摘要
• 知识面板
• 最佳有机结果
• 人们也问

要求：

• Chrome必须打开
• 必须安装扩展
• 扩展令牌和服务器令牌必须匹配

fetch_and_filter

获取URL并仅返回相关内容。

没有 OPENROUTER_API_KEY:

• 返回页面中已清理的Markdown

随着 OPENROUTER_API_KEY:

• 使用LLM仅提取与查询匹配的部分
• 如果根页面不包含答案，则可以遵循相关子链接

客户示例

克劳德桌面

{
  "mcpServers": {
    "my-google-search-mcp": {
      "command": "npx",
      "args": ["-y", "my-google-search-mcp"]
    }
  }
}

VS代码/副本/光标

{
  "mcpServers": {
    "my-google-search-mcp": {
      "command": "npx",
      "args": ["-y", "my-google-search-mcp"]
    }
  }
}

有环境变量

{
  "mcpServers": {
    "my-google-search-mcp": {
      "command": "npx",
      "args": ["-y", "my-google-search-mcp"],
      "env": {
        "BRIDGE_TOKEN": "your-secret-token",
        "OPENROUTER_API_KEY": "sk-or-v1-..."
      }
    }
  }
}

环境变量

您可以使用 .env.example 或者通过MCP客户端提供env变量：

OPENROUTER_API_KEY=sk-or-v1-...
OPENROUTER_MODEL=google/gemini-2.0-flash-001
BRIDGE_TOKEN=your-secret-token

故障排除

扩展未连接

• 确保Chrome已打开
• 确保已加载扩展
• 确保令牌在 background.js 匹配服务器令牌

fetch_and_filter 返回整页内容

这意味着 OPENROUTER_API_KEY 未设置。该工具仍然有效，但它跳过了LLM过滤。

谷歌搜索结果无法正确解析

Google经常更改DOM。如果发生这种情况，请更新中的选择器 chrome-extension/background.js.

安全说明

• 网桥请求需要共享令牌
• 桥只听 127.0.0.1
• 搜索请求有速率限制
• fetch_and_filter 阻止本地主机和私有/内部IP范围
• 在LLM提取过程中，快速注入被视为不受信任的页面内容
• 错误消息在返回给客户端之前会被净化

本地开发

git clone https://github.com/dev-tahir/my-google-search-mcp
cd my-google-search-mcp
npm install
npm run build
npm start

开发模式：

npm run dev

回购结构

src/
  bin.ts              CLI entrypoint
  index.ts            MCP server and tool registration
  bridge.ts           local bridge between MCP server and Chrome extension
  fetcher.ts          HTML fetching, cleanup, and Markdown conversion
  llm.ts              OpenRouter integration
  site-search.ts      query-driven extraction and link-following

chrome-extension/
  background.js       Chrome extension service worker
  manifest.json       extension manifest

出版说明

• npm包名称： my-google-search-mcp
• 二进制入口点： my-google-search-mcp
• 许可证：麻省理工学院

许可证

麻省理工学院