Gemini MCP服务器
一个强大的MCP（模型上下文协议）服务器，将谷歌最新的Gemini AI模型带到您最喜欢的开发环境中。通过无缝集成访问Gemini 2.5的思维能力、视觉分析、嵌入等。
🚀 适用于：Claude Desktop、Cursor、Windsurf和任何兼容MCP的客户端\ 🎯 为什么使用这个：通过完整的参数控制，直接在IDE中获取Gemini的尖端AI功能\ 📚 自我记录：内置的帮助系统意味着您永远不需要离开编辑器
特性
- 6强大的工具：文本生成、图像分析、令牌计数、模型列表、嵌入和自文档帮助
- 最新Gemini型号：支持具有思考能力的Gemini 2.5系列
- 高级功能：JSON模式、谷歌搜索基础、系统指令、对话记忆
- 完整的MCP协议：标准stdio通信，可与任何MCP客户端无缝集成
- 自我记录：内置帮助系统-无需外部文档
- TypeScript和ESM：现代、类型安全的实施
支持的型号
| 模型 | 上下文 | 功能 | 最适合 |
|---|---|---|---|
| gemini-2.5-pro | 2M令牌 | 思考、JSON、基础 | 复杂推理 |
| 双子座-2.5-flash⭐ | 1M代币 | 思考、JSON、接地 | 通用 |
| gemini-2.5-flash-lite | 1M代币 | 思考，JSON | 快速响应 |
| gemini-2.0-flash | 1M令牌 | JSON，接地 | 标准任务 |
| gemini-1.5-pro | 2M令牌 | JSON | 遗留支持 |
快速开始
- 获取Gemini API密钥
- 访问 谷歌AI工作室 - 创建新的API密钥 - 重要：确保API密钥的安全，永远不要将其提交给版本控制
- 配置您的MCP客户端
Claude Desktop
配置位置：
- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %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设置中进行配置。
Other MCP Clients
使用标准MCP stdio配置：
{
"type": "stdio",
"command": "npx",
"args": ["-y", "github:aliargun/mcp-server-gemini"],
"env": {
"GEMINI_API_KEY": "your_api_key_here"
}
}- 重新启动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服务器？
- 访问最新型号：使用具有思考能力的Gemini 2.5-谷歌最先进的模型
- 全功能集：所有Gemini API功能，包括JSON模式、基础和系统指令
- 轻松设置：单线npx安装，无需复杂配置
- 生产就绪：全面的错误处理、TypeScript类型和广泛的文档
- 积极发展：Gemini新功能发布后定期更新
文档
- 使用指南 -使用所有工具和功能的完整指南
- 参数参考 -所有参数的详细文档
- 快速参考 -快速命令备忘单
- 增强功能 -v4.0.0功能的详细列表
- Claude桌面设置指南 -详细的设置说明
- 示例和用法 -使用示例和高级配置
- 实现注意事项 -技术实施细节
- 开发指南 -开发者指南
- 故障排除指南 -常见问题和解决方案
地方发展
# 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贡献
欢迎投稿！请查看我们的 贡献指南.
常见问题
- 连接问题
- 确保您的MCP客户端已正确重启 - 检查客户端的日志（例如。， ~/Library/Logs/Claude/mcp-server-gemini.log 适用于Mac上的Claude Desktop） - 验证互联网连接 - 看 故障排除指南
- API关键问题
- 验证API密钥是否正确 - 检查API密钥是否具有正确的权限 - 确保在环境变量中设置了密钥 - 看 安装指南
安全
- API密钥仅通过环境变量处理
- 永远不要将API密钥提交到版本控制
- 这
.claude/目录已从git中排除 - 没有记录或存储敏感数据
- 定期安全更新
- 如果您的API密钥被暴露，请立即在Google云控制台中重新生成它
许可证
麻省理工学院