Gemini MCP Server

Gemini MCP Server

这是一款功能强大的 MCP（Model Context Protocol）服务，可将 Google 最新的 Gemini AI 模型引入你喜爱的开发环境。通过无缝集成，使用 Gemini 2.5 的思考能力、视觉分析、嵌入等功能。

🚀 适用于：Claude Desktop、Cursor、Windsurf，以及任何兼容 MCP 的客户端
🎯 使用理由：在 IDE 中直接使用 Gemini 的前沿 AI 功能，并全面控制参数
📚 自带文档：内置帮助系统，无需离开编辑器

功能

• 6 款强大工具：文本生成、图像分析、Token 计数、模型列表、嵌入和自带文档的帮助系统
• 最新 Gemini 模型：支持具备思考能力的 Gemini 2.5 系列
• 高级功能：JSON 模式、Google Search grounding、系统指令、对话记忆
• 完整 MCP 协议：标准 stdio 通信，可无缝集成任何 MCP 客户端
• 自带文档：内置帮助系统，无需外部文档
• TypeScript 和 ESM：现代化、类型安全的实现

支持的模型

模型	上下文	功能	最适合
gemini-2.5-pro	2M tokens	思考、JSON、Grounding	复杂推理
gemini-2.5-flash ⭐	1M tokens	思考、JSON、Grounding	通用场景
gemini-2.5-flash-lite	1M tokens	思考、JSON	快速响应
gemini-2.0-flash	1M tokens	JSON、Grounding	常规任务
gemini-1.5-pro	2M tokens	JSON	兼容旧版

快速开始

1. 获取 Gemini API 密钥

   • 访问 Google AI Studio
   • 创建新的 API 密钥
   • 重要：妥善保管 API 密钥，切勿将其提交到版本控制系统

2. 配置 MCP 客户端

   Claude Desktop

   配置文件位置：

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

   {
     "mcpServers": {
       "gemini": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "github:aliargun/mcp-server-gemini"],
         "env": {
           "GEMINI_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

   Cursor

   添加到 Cursor 的 MCP 设置：

   {
     "gemini": {
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "github:aliargun/mcp-server-gemini"],
       "env": {
         "GEMINI_API_KEY": "your_api_key_here"
       }
     }
   }
   

   Windsurf

   按照 Windsurf 文档在其 MCP 设置中进行配置。

   其他 MCP 客户端

   使用标准 MCP stdio 配置：

   {
     "type": "stdio",
     "command": "npx",
     "args": ["-y", "github:aliargun/mcp-server-gemini"],
     "env": {
       "GEMINI_API_KEY": "your_api_key_here"
     }
   }
   

3. 重启 MCP 客户端

使用方法

配置完成后，你可以在 MCP 客户端中使用自然语言来调用 Gemini 的功能：

基本命令

"Use Gemini to explain quantum computing"
"Analyze this image with Gemini" 
"List all Gemini models"
"Get help on using Gemini"

高级示例

"Use Gemini 2.5 Pro with temperature 0.3 to review this code"
"Use Gemini in JSON mode to extract key points with schema {title, summary, tags}"
"Use Gemini with grounding to research the latest in quantum computing"

📖 查看完整使用指南，了解详细示例和高级功能。

为什么选择 Gemini MCP Server？

• 使用最新模型：使用具备思考能力的 Gemini 2.5——Google 最先进的模型
• 完整功能集：涵盖 Gemini API 的所有功能，包括 JSON 模式、grounding 和系统指令
• 轻松设置：只需一行 npx 命令即可安装，无需复杂配置
• 可用于生产环境：完善的错误处理、TypeScript 类型和详尽的文档
• 持续开发：随着 Gemini 新功能发布定期更新

文档

• 使用指南 - 使用所有工具和功能的完整指南
• 参数参考 - 所有参数的详细文档
• 快速参考 - 命令速查表
• 增强功能 - v4.0.0 功能的详细列表
• Claude Desktop 设置指南 - 详细的设置说明
• 示例和用法 - 使用示例和高级配置
• 实现说明 - 技术实现细节
• 开发指南 - 面向开发者的指南
• 故障排除指南 - 常见问题及解决方案

本地开发

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

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY

# Start development server
npm run dev

贡献

欢迎贡献！请参阅我们的贡献指南。

常见问题

1. 连接问题

   • 确保已正确重启 MCP 客户端
   • 检查客户端日志（例如，在 Mac 上使用 Claude Desktop 时，查看 ~/Library/Logs/Claude/mcp-server-gemini.log）
   • 确认网络连接正常
   • 请参阅故障排除指南

2. API 密钥问题

   • 确认 API 密钥正确
   • 检查 API 密钥是否具有适当的权限
   • 确保已在环境变量中设置密钥
   • 请参阅设置指南

安全

• API 密钥仅通过环境变量处理
• 切勿将 API 密钥提交到版本控制系统
• .claude/ 目录已从 git 中排除
• 不会记录或存储敏感数据
• 定期进行安全更新
• 如果 API 密钥泄露，请立即在 Google Cloud Console 中重新生成

许可证

MIT