Google Research MCP Server

版本 3.0.0 - 增强的研究综合功能，包括智能源质量评估和去重。

这是一个先进的模型上下文协议（MCP）服务器，提供全面的Google搜索能力、网页内容提取以及AI驱动的研究综合。适用于Claude Code、Claude Desktop和其他兼容MCP的客户端。

概述

此MCP服务器通过以下方式将Google搜索转变为强大的研究工具：

• 智能源排序 - 自动根据权威性、时效性和可信度对来源进行评分
• 去重 - 移除重复的URL和相似的内容
• 基于代理的综合 - 利用现有的Claude会话来综合研究发现
• 焦点领域分析 - 提供特定研究主题方面的专门分析
• 质量指标 - 跟踪来源多样性、权威性和内容新鲜度

快速开始

先决条件

• Node.js 18或更高版本
• 启用了自定义搜索API的Google云平台账户
• Google自定义搜索引擎ID

安装

# 克隆仓库
git clone <repository-url>
cd Google-Research-MCP

# 安装依赖
npm install

# 构建项目
npm run build

配置

在项目根目录创建一个.env文件：

GOOGLE_API_KEY=your_google_api_key
GOOGLE_SEARCH_ENGINE_ID=your_custom_search_engine_id

注意： 不需要Anthropic API密钥。服务器使用基于代理的综合，利用您现有的Claude会话。

运行服务器

# 启动v3服务器（推荐）
npm run start:v3

# 对于HTTP模式
npm run start:v3:http

预期输出：

============================================================
Google Research MCP Server v3.0.0 (增强版)
============================================================
✓ 源质量评估
✓ 去重
✓ AI综合：代理模式（Claude将启动代理）
  └─ 不需要API密钥 - 使用您的现有Claude会话
✓ 焦点领域分析
✓ 增强的错误处理
✓ 缓存元数据
============================================================
服务器正在STDIO上运行

功能

核心能力

1. 高级Google搜索

• 带质量评分的全文搜索
• 域名过滤和日期限制
• 结果分类（学术、官方文档、新闻、论坛等）
• 结果自动去重
• 来源权威性排名

2. 内容提取

• 从网页中干净地提取内容
• 多种输出格式（Markdown、HTML、纯文本）
• 可配置的预览长度
• 批量提取支持（最多5个URL）
• 自动内容总结

3. 研究综合

• 基于代理的研究分析
• 综合来源合成
• 焦点领域分解
• 矛盾检测
• 可操作建议
• 质量指标报告

研究深度级别

深度	来源	分析	使用案例
基础	3	快速概览，3-5个发现	快速比较，初步研究
中级	5	综合分析，5-7个发现	标准研究任务
高级	8-10	深入分析，7-10个发现，矛盾	决策制定，全面审查

使用示例

基础研究

research_topic({
  topic: "WebAssembly性能优化",
  depth: "基础"
})

返回：

• 3个高质量来源
• 简要概述（2-3段落）
• 3-5个关键发现
• 质量指标

全面研究与焦点领域

research_topic({
  topic: "Kubernetes安全",
  depth: "高级",
  focus_areas: ["RBAC", "网络策略", "Pod安全"],
  num_sources: 8
})

返回：

• 8个权威来源
• 深入执行摘要
• 7-10个详细发现
• 来源中的共同主题
• 每个焦点领域的专门分析
• 来源之间的矛盾
• 可操作建议
• 综合质量指标

目标搜索

google_search({
  query: "Docker容器安全性最佳实践",
  num_results: 10,
  dateRestrict: "y1",  // 仅限去年
  site: "github.com"   // 限制到GitHub
})

返回：

• 带质量评分的结果
• 去重报告
• 来源类型分类
• 权威评级

内容提取

extract_webpage_content({
  url: "https://kubernetes.io/docs/concepts/security/",
  format: "markdown",
  max_length: 5000,
  preview_length: 300
})

返回：

• 清洁提取的内容
• 元数据（标题、描述、作者）
• 字数统计
• 可配置预览
• 缓存信息

代理模式

工作原理

代理模式是默认的综合方法。它不需要单独的Anthropic API密钥，而是利用您现有的Claude会话：

1. 研究收集 - MCP服务器搜索、去重并排名来源
2. 内容提取 - 从顶级来源完全提取内容
3. 代理提示生成 - 将所有研究数据打包成结构化提示
4. 代理启动 - Claude Code自动启动带有研究数据的代理
5. 综合 - 代理分析来源并生成综合报告

优点

• 无需额外API密钥 - 使用您现有的Claude订阅
• 全上下文 - 代理可以访问对话历史
• 透明过程 - 实时查看代理分析
• 相同质量 - 使用您已经在使用的Claude模型

替代方案：直接API模式

对于自动化工作流或脚本，您可以使用直接API模式：

# .env
ANTHROPIC_API_KEY=your_anthropic_api_key
USE_DIRECT_API=true

这绕过了代理模式，并直接从MCP服务器调用Anthropic API。

架构

服务

src/
├── google-search-v3.ts              # 主MCP服务器（v3）
├── services/
│   ├── google-search.service.ts     # Google自定义搜索集成
│   ├── content-extractor.service.ts # 网页内容提取
│   ├── source-quality.service.ts    # 来源排名和评分
│   ├── deduplication.service.ts     # 重复检测
│   └── research-synthesis.service.ts # 基于代理的综合
└── types.ts                          # TypeScript接口

数据流

搜索查询 → Google API → 结果
                              ↓
                         去重
                              ↓
                         质量评分
                              ↓
                         内容提取
                              ↓
                         代理综合
                              ↓
                    综合研究报告

API参考

工具

google_search

使用高级过滤和质量评分搜索Google。

参数：

• query (字符串，必需) - 搜索查询
• num_results (数字，可选) - 结果数量（默认：5，最大：10）
• site (字符串，可选) - 限制到特定域名
• language (字符串，可选) - ISO 639-1语言代码
• dateRestrict (字符串，可选) - 日期过滤器（例如，“m6”表示过去6个月）
• exactTerms (字符串，可选) - 精确短语匹配
• resultType (字符串，可选) - 按类型过滤（图像、新闻、视频）
• page (数字，可选) - 分页
• sort (字符串，可选) - 按相关性或日期排序

返回：

• 带质量评分的排名搜索结果
• 去重统计
• 来源分类
• 分页信息
• 缓存元数据

extract_webpage_content

从网页中提取干净的内容。

参数：

• url (字符串，必需) - 目标URL
• format (枚举，可选) - 输出格式：markdown、html、text（默认：markdown）
• full_content (布尔值，可选) - 返回完整内容（默认：false）
• max_length (数字，可选) - 最大内容长度
• preview_length (数字，可选) - 预览长度（默认：500）

返回：

• 提取的内容
• 元数据（标题、描述、作者）
• 统计数据（字数、字符数）
• 内容摘要
• 缓存信息

extract_multiple_webpages

批量提取多个URL的内容（最多5个）。

参数：

• urls (数组，必需) - URL数组（最多5个）
• format (枚举，可选) - 输出格式

返回：

• 每个URL的提取内容
• 提取失败的错误详情
• 缓存元数据

research_topic

全面研究，带AI综合。

参数：

• topic (字符串，必需) - 研究主题
• depth (枚举，可选) - 分析深度：基础、中级、高级（默认：中级）
• num_sources (数字，可选) - 来源数量（默认：根据深度变化）
• focus_areas (数组，可选) - 要分析的具体方面

返回：

• 执行摘要
• 带引用的关键发现
• 共同主题
• 焦点领域分析（如果指定）
• 来源之间的矛盾
• 建议
• 质量指标（来源多样性、权威性、新鲜度）
• 带质量评分的来源列表

配置选项

环境变量

变量	必需	默认	描述
GOOGLE_API_KEY	是	-	Google自定义搜索API密钥
GOOGLE_SEARCH_ENGINE_ID	是	-	自定义搜索引擎ID
ANTHROPIC_API_KEY	否	-	仅用于直接API模式
USE_DIRECT_API	否	false	启用直接API模式
MCP_TRANSPORT	否	stdio	传输模式：stdio或http
PORT	否	3000	HTTP模式端口

性能

响应时间

操作	典型持续时间	备注
google_search	1-2秒	包括质量评分和去重
extract_webpage_content	2-3秒	每个URL
research_topic (基础)	8-10秒	3个来源，带代理综合
research_topic (中级)	12-15秒	5个来源，带综合分析
research_topic (高级)	18-25秒	8-10个来源，带深入分析

质量改进对比v2

指标	v2	v3	改进
摘要质量	2/10	9/10	350%
来源多样性	未跟踪	优化	新增
重复移除	0%	~30%	新增
来源排名	随机	按质量	新增
焦点领域支持	通用	专用	新增
错误帮助性	3/10	9/10	200%

故障排除

代理模式无法工作

症状： 研究返回基本拼接而不是综合

解决方案：

1. 验证服务器启动时显示“代理模式”
2. 检查响应中是否有 [AGENT_SYNTHESIS_REQUIRED]
3. 确保使用v3：npm run start:v3
4. 重新构建：npm run build

质量评分缺失

症状： 搜索结果没有显示质量评分

解决方案：

1. 确认运行的是v3，而非v2
2. 检查服务器启动输出
3. 确认没有TypeScript编译错误

没有找到结果

解决方案：

1. 验证Google API密钥有效
2. 检查自定义搜索引擎ID
3. 确保搜索引擎已启用索引
4. 尝试更广泛的搜索词

文档

• QUICK-START.md - 快速设置指南（2分钟）
• AGENT-MODE.md - 详细的代理模式文档
• SETUP-V3.md - 详细的设置和测试指南
• README-V3.md - 特性文档和比较
• tool-evaluation-report.md - 详细的改进分析
• implementation-guide.md - 代码实现细节

版本历史

v3.0.0（当前）

• 基于代理的综合（无需API密钥）
• 源质量评估和排名
• 综合去重
• 焦点领域分析
• 带建议的增强错误处理
• 缓存元数据透明
• 一致的预览长度
• 研究深度区分

v2.0.0

• HTTP传输支持
• 批量网页提取
• 基础研究综合
• 内容分类

v1.0.0

• 初始发布
• Google自定义搜索集成
• 基础内容提取

贡献

欢迎贡献。请确保：

1. 代码遵循现有的风格约定
2. 所有测试通过：npm run build
3. 更新文档
4. 提交消息描述清晰

许可

详见LICENSE文件。

支持

如有问题、疑问或功能请求，请在GitHub上打开一个issue。

致谢

• Google自定义搜索API - 搜索功能
• Anthropic Claude - AI驱动的研究综合
• Mozilla Readability - 内容提取
• MCP SDK - 模型上下文协议集成

---

状态： 生产就绪 版本： 3.0.0 最后更新： 2025-11-07