Google Researcher MCP Server

Google Researcher MCP Server

site icon
2025.05.04 0
TypeScriptAI研究工具网络信息获取AI增强搜索工具开发效率
Google Researcher MCP Server 是一个基于 Model Context Protocol (MCP) 的开源项目,旨在为 AI 助手提供强大的网络研究能力。通过集成 Google 搜索、网页内容抓取和 Gemini AI 分析功能,该服务器能够帮助 AI 客户端执行复杂的研究任务,并通过持久化缓存提高性能并降低 API 调用成本。
View on GitHub

Overview

基本能力

产品定位

Google Researcher MCP Server 是一个为 AI 助手提供网络研究能力的中间件服务,通过集成多种网络工具和 AI 分析功能,扩展 AI 的实时信息获取和处理能力。

核心功能

  • 研究工具
  • google_search: 通过 Google Search API 查找信息
  • scrape_page: 从网站和 YouTube 视频中提取内容
  • analyze_with_gemini: 使用 Google 的 Gemini AI 处理文本
  • research_topic: 结合搜索、抓取和分析的完整研究流程

  • 性能与可靠性

  • 持久化缓存系统(内存+磁盘)
  • 支持会话恢复
  • 多种传输选项(STDIO, HTTP+SSE)
  • 管理 API 端点用于监控和控制

适用场景

  • 为 AI 助手扩展实时网络信息获取能力
  • 减少 API 调用成本的研究项目
  • 需要重复查询相同信息的应用场景
  • 需要结合搜索和 AI 分析的研究工作流

工具列表

工具 描述
google_search 通过 Google Search API 搜索网络信息
scrape_page 从指定 URL 提取网页内容
analyze_with_gemini 使用 Gemini AI 处理和分析文本
research_topic 完整的研究工作流,结合搜索、抓取和分析

常见问题解答

  1. 如何获取 API 密钥?
  2. Google Custom Search API key: https://developers.google.com/custom-search/v1/introduction
  3. Google Gemini API key: https://ai.google.dev/

  4. 如何清除缓存? 使用 POST /mcp/cache-invalidate 端点(需要 API key)

  5. 支持哪些传输方式? 支持 STDIO 和 HTTP+SSE 两种传输方式

使用教程

使用依赖

  • Node.js v18+
  • 需要以下 API 密钥:
  • Google Custom Search API key
  • Google Custom Search Engine ID
  • Google Gemini API key

安装教程

  1. 克隆并安装:
git clone <repository-url>
cd <repository-directory>
npm install
  1. 配置环境变量:
cp .env.example .env
# 编辑 .env 文件填入您的 API 密钥
  1. 运行服务器:
  2. 开发模式(自动重载):
npm run dev
  • 生产模式:
npm run build
npm start

调试方式

  1. 验证服务器是否正常运行:
✅ stdio transport ready
🌐 SSE server listening on http://127.0.0.1:3000/mcp
  1. 运行测试:
npm test  # 运行组件测试
npm run test:e2e  # 运行端到端测试

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。