你是否曾经希望Claude Desktop能够访问Google的Gemini AI模型,结合两者的优势?今天要介绍的开源项目MCP Gemini服务器实现,正是为了实现这个目标而设计的。它是一个MCP服务器实现,使Claude Desktop能够与Google的Gemini AI模型进行交互。
项目基本信息
| 信息项 | 详情 |
|---|---|
| 项目名称 | MCP Gemini 服务器实现 |
| GitHub地址 | https://github.com/aliargun/mcp-server-gemini |
| 项目描述 | 模型上下文协议(MCP)服务器实现,使克劳德桌面能够与谷歌的双子座AI模型进行交互。 |
| 作者 | aliargun |
| 开源协议 | MIT License |
| 开源状态 | 公开状态 |
| Languages | TypeScript |
| 支持平台 | Windows / macOS / Linux |
| 最后更新 | 2026-04-23 |
一、项目介绍
MCP Gemini服务器实现是一个让Claude Desktop能够调用Google Gemini AI模型的MCP工具。它支持完整的MCP协议,提供实时响应流,并具有安全的API密钥处理。
这个服务器的核心特性包括:
- 完整的MCP协议支持
- 实时响应流
- 安全的API密钥处理
- 可配置的模型参数
- TypeScript实现
二、核心优势
跨模型集成
让Claude Desktop使用Gemini模型。
实时流式
支持实时响应流,体验流畅。
安全处理
API密钥通过环境变量安全处理。
TypeScript实现
完整的类型安全。
MIT许可证
可自由使用和修改。
三、适用场景
模型切换
在Claude Desktop中使用Gemini模型。
多模型对比
对比Claude和Gemini的输出效果。
特定任务优化
使用Gemini更适合某些任务。
开发测试
测试Gemini模型的能力。
四、安装教程
系统要求
| 工具 | 用途 | 下载/安装方式 |
|---|---|---|
| Node.js | 运行环境 | [https://nodejs.org/] (版本要求:18.0 或更高) |
| Gemini API密钥 | 认证 | Google AI Studio获取 |
| MCP客户端 | Claude Desktop | [https://claude.ai/download] |
安装步骤
第一步:获取Gemini API密钥
- 访问Google AI Studio
- 创建新的API密钥
- 复制保存密钥
第二步:配置Claude Desktop
找到配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
添加配置:
{
"mcpServers": {
"gemini": {
"command": "npx",
"args": ["-y", "github:aliargun/mcp-server-gemini"],
"env": {
"GEMINI_API_KEY": "your_api_key_here"
}
}
}
}第三步:重启Claude Desktop
保存配置后,重启Claude Desktop。
五、本地开发
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini
npm install
npm run dev六、使用示例
配置完成后,在Claude Desktop中就可以使用Gemini模型的能力了。
示例对话
用户:“使用Gemini模型帮我解释一下量子计算”
Claude会通过MCP服务器调用Gemini API,返回Gemini的响应。
七、常见问题
问题1:连接失败
解决方案:检查端口3005是否可用,验证网络连接。
问题2:API密钥无效
解决方案:验证API密钥是否正确,检查权限。
问题3:超时错误
解决方案:检查网络连接,增加超时设置。
问题4:模型不可用
解决方案:确认API密钥有访问Gemini模型的权限。
问题5:响应格式问题
解决方案:检查Gemini API版本兼容性。
八、总结
MCP Gemini服务器实现是一个让Claude Desktop能够使用Google Gemini模型的MCP工具。
这个项目的最大价值在于:
- 跨模型集成:Claude Desktop调用Gemini
- 实时流式:流畅的响应体验
- 安全处理:API密钥环境变量
- TypeScript:类型安全
- MIT许可证:可自由使用
如果你希望在Claude Desktop中使用Gemini模型,MCP Gemini服务器实现是一个非常实用的工具。
Claude Desktop能用Gemini了。
590查看量,这个项目很实用。
跨模型集成很创新。
实时流式响应。
TypeScript实现。