Gemini MCP Server

一个强大的MCP（模型上下文协议）服务器，将Google最新的Gemini AI模型带入您最喜欢的开发环境。通过无缝集成，您可以访问Gemini 2.5的思考能力、视觉分析、嵌入式内容等。

🚀 兼容工具：Claude Desktop、Cursor、Windsurf以及任何支持MCP的客户端
🎯 为什么使用它：在您的IDE中直接获取Gemini的尖端AI特性，并拥有完整的参数控制
📚 自文档化：内置的帮助系统意味着您无需离开编辑器即可获得帮助

功能

• 6大强大工具：文本生成、图像分析、令牌计数、模型列表、嵌入式内容以及自文档化帮助
• 最新Gemini模型：支持具有思考能力的Gemini 2.5系列
• 高级功能：JSON模式、Google搜索基础、系统指令、对话记忆
• 全面的MCP协议：标准的stdio通信，实现与任何MCP客户端的无缝集成
• 自文档化：内置的帮助系统——无需外部文档
• TypeScript & ESM：现代且类型安全的实现

支持的模型

模型	上下文	特性	最佳用途
gemini-2.5-pro	2M 令牌	思考、JSON、基础	复杂推理
gemini-2.5-flash ⭐	1M 令牌	思考、JSON、基础	通用用途
gemini-2.5-flash-lite	1M 令牌	思考、JSON	快速响应
gemini-2.0-flash	1M 令牌	JSON、基础	标准任务
gemini-1.5-pro	2M 令牌	JSON	向后兼容

快速开始

1. 获取Gemini API密钥

   • 访问Google AI Studio
   • 创建一个新的API密钥
   • 重要：确保您的API密钥安全，切勿将其提交到版本控制系统

2. 配置您的MCP客户端

   <details> <summary><b>Claude Desktop</b></summary>

   配置位置：

   • 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"
         }
       }
     }
   }
   

   </details> <details> <summary><b>Cursor</b></summary>

   添加到Cursor的MCP设置：

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

   </details> <details> <summary><b>Windsurf</b></summary>

   根据Windsurf的文档配置其MCP设置。

   </details> <details> <summary><b>其他MCP客户端</b></summary>

   使用标准的MCP stdio配置：

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

   </details>

3. 重启您的MCP客户端

如何使用

配置完成后，您可以在MCP客户端中使用自然语言来访问Gemini的能力：

基础命令

"用Gemini解释量子计算"
"用Gemini分析这张图片"
"列出所有Gemini模型"
"获取关于如何使用Gemini的帮助"

高级示例

"使用温度为0.3的Gemini 2.5 Pro审查这段代码"
"使用Gemini的JSON模式提取关键点，模式为{title, summary, tags}"
"使用带有基础的Gemini研究最新的量子计算进展"

📖 查看完整的使用指南 以获取详细的示例和高级功能。

为什么选择Gemini MCP Server？

• 访问最新模型：使用具有思考能力的Gemini 2.5——Google最先进的模型
• 完整功能集：包括JSON模式、基础和系统指令在内的所有Gemini API功能
• 简单设置：一行npx安装，无需复杂的配置
• 生产就绪：全面的错误处理、TypeScript类型和详尽的文档
• 持续开发：随着新Gemini特性的发布，定期更新

文档

• 使用指南 —— 完整地指导如何使用所有工具和功能
• 参数参考 —— 所有参数的详细文档
• 快速参考 —— 快速命令备忘单
• 增强功能 —— 详细列出v4.0.0的功能
• Claude Desktop 设置指南 —— 详细的设置说明
• 示例和使用 —— 使用示例和高级配置
• 实施说明 —— 技术实施细节
• 开发者指南 —— 开发者指南
• 故障排除指南 —— 常见问题及解决方案

本地开发

# 克隆仓库
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# 安装依赖
npm install

# 设置环境变量
cp .env.example .env
# 编辑.env并添加您的GEMINI_API_KEY

# 启动开发服务器
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