Gemini Search MCP Server 使用说明

项目简介

Gemini Search MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为 AI 助手等 MCP 客户端提供强大的信息检索和文件分析能力。它集成了 Google Gemini API 和 Google 搜索，能够根据用户查询，利用最新的在线信息生成回答，并能分析本地文件内容，包括图片和PDF文件。

主要功能点

信息检索 (search): 通过 Gemini API 和 Google 搜索，根据用户query检索最新的网络信息并生成答案，同时返回相关搜索结果，确保信息是最新的。
文件分析 (analyze_file): 利用 Gemini API 的多模态能力，分析本地的单个文件，目前支持图片 (JPEG) 和 PDF 文件，并根据用户query进行文件内容分析。
多文件分析 (analyze_files): 支持同时分析多个本地文件，可以用于比较文件内容、分析文件之间的关联性等，同样支持图片 (JPEG)、PDF 和 Markdown 文件。

安装步骤

安装依赖: 在项目根目录下打开终端，运行 'npm install' 命令安装项目所需的依赖包。
构建项目: 运行 'npm run build' 命令，将 TypeScript 代码编译为 JavaScript 代码，生成可执行的服务器文件。
配置环境变量:
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加 'GEMINI_API_KEY=your_api_key_here'，并将 'your_api_key_here' 替换为您从 Google AI Studio 获取的 Gemini API 密钥。

服务器配置

要将 Gemini Search MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端以连接到此服务器。以下是配置示例，通常您需要在 MCP 客户端的配置文件（如 'claude_desktop_config.json'）中添加 'mcpServers' 配置项：

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["path/to/gemini-search-server/build/index.js"]
    }
  }
}

配置参数说明:

'server name': 'gemini' (用户自定义，用于在客户端中标识该服务器)
'command': 'node' (Node.js 运行时环境命令)
'args': '["path/to/gemini-search-server/build/index.js"]' (服务器启动脚本的路径，请将 'path/to/gemini-search-server' 替换为您的 Gemini Search MCP Server 项目的实际路径)

注意: 'env' 环境变量配置通常由 MCP 客户端自身管理，或者在更高级的配置中指定。本例中 Gemini API Key 已通过 '.env' 文件配置，客户端无需额外配置 'env' 字段。

基本使用方法

确保已完成安装步骤并正确配置环境变量和服务器配置。
启动 Gemini Search MCP Server。在项目根目录下打开终端，运行 'node build/index.js' 命令启动服务器。服务器成功启动后，会在终端输出 'Gemini Search MCP server running on stdio' 提示信息。
在 MCP 客户端（如 Cline 或 Claude Desktop）中加载并启用已配置的 'gemini' MCP 服务器。
在 MCP 客户端中，当需要使用 Gemini 搜索或文件分析功能时，客户端会通过 MCP 协议调用 Gemini Search MCP Server 提供的 'search', 'analyze_file', 或 'analyze_files' 工具，并将结果返回给用户。

例如，在 Claude Desktop 中使用: 在对话中，您可以像平常一样提问。当 Claude 需要联网搜索最新信息或分析文件时，如果配置并启用了 Gemini Search MCP Server，Claude 就会自动调用相应的工具来完成任务，并将 Gemini 生成的答案或文件分析结果整合到对话回复中。您无需手动指定使用哪个工具，这一切对用户是透明的。

调试: 如果遇到问题，可以使用 MCP Inspector 进行调试，运行 'npm run inspector' 命令可以启动 Inspector，它提供了一个浏览器界面来监控和分析 MCP 服务器与客户端之间的通信。

关键词