使用说明

项目简介

Gemini MCP Server 是一个实现了 Model Context Protocol (MCP) 协议的服务器，它允许 Claude Desktop 等 MCP 客户端与 Google 的 Gemini AI 模型进行交互。通过该服务器，您可以利用 Gemini 强大的语言模型能力，为 Claude Desktop 提供文本生成等服务。

主要功能点

完整的 MCP 协议支持: 实现了 MCP 协议的关键功能，例如初始化、文本生成、流式响应、取消请求和配置等。
实时响应流: 支持服务器向客户端实时推送生成结果，提升用户体验。
安全的 API 密钥处理: 通过环境变量安全地管理 Gemini API 密钥。
可配置的模型参数: 允许用户配置 Gemini 模型的参数，例如温度系数、最大输出 tokens 等。

安装步骤

获取 Gemini API Key: 访问 Google AI Studio 并创建一个新的 API 密钥。

克隆仓库: 将仓库 'https://github.com/aliargun/mcp-server-gemini' 克隆到本地。

git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

安装依赖: 在项目根目录下运行 'npm install' 安装项目依赖。
```
npm install
```

服务器配置

要将 Gemini MCP Server 集成到 Claude Desktop，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，并添加 Gemini 服务器的配置信息。

配置文件路径:

Mac: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'
Linux: '~/.config/Claude/claude_desktop_config.json'

配置内容 (添加到 'mcpServers' 字段):

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "github:aliargun/mcp-server-gemini"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"  // 替换为您的 Gemini API 密钥
      }
    }
  }
}

配置参数说明:

'"gemini"': 服务器名称，可以自定义，用于在 Claude Desktop 中标识该服务器。
'"command": "npx"': 启动服务器的命令，这里使用 'npx' 直接运行 GitHub 仓库。
'"args": ["-y", "github:aliargun/mcp-server-gemini"]': 'npx' 命令的参数，'-y' 表示自动确认安装，'github:aliargun/mcp-server-gemini' 指定要运行的 GitHub 仓库。
'"env": { "GEMINI_API_KEY": "your_api_key_here" }': 设置环境变量，'GEMINI_API_KEY' 用于存储您的 Gemini API 密钥，请务必替换为您的实际 API 密钥。

本地开发配置 (如果您希望本地运行服务器):

如果您选择本地运行服务器进行开发或测试，可以使用以下配置，并先按照 本地开发 步骤启动服务器：

{
  "mcpServers": {
    "gemini-local": {  // 修改服务器名称，避免与远程配置冲突
      "command": "npm",
      "args": ["run", "dev"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here" // 同样需要替换为您的 API 密钥
      }
    }
  }
}

本地开发步骤:

克隆仓库并 'cd mcp-server-gemini' 进入项目目录。
安装依赖 'npm install'。
复制 '.env.example' 文件为 '.env'，并在 '.env' 文件中设置 'GEMINI_API_KEY=your_api_key_here' (替换为您的 API 密钥)。
启动开发服务器 'npm run dev'。

基本使用方法

配置完成后，重启 Claude Desktop 客户端，即可在 Claude Desktop 中选择您配置的 Gemini 服务器进行对话，体验由 Gemini 模型驱动的文本生成服务。

关键词