Aliargun MCP Server Gemini

🚀 通用 Gemini MCP 服务器

本项目是一个实现 Google Gemini AI 模型与 Claude Desktop 交互的 Model Context Protocol (MCP) 服务器，能有效促进两者间的通信，提升使用效率。

🚀 快速开始

获取 API 密钥

• 访问 Google AI 工作室。
• 创建一个新的 API 密钥。

配置 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

• 添加 Gemini 配置：

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "github:aliargun/mcp-server-gemini"],
      "env": {
        "GEMINI_API_KEY": "你的 API 密钥"
      }
    }
  }
}

重启 Claude Desktop

完成上述配置后，重启 Claude Desktop 使配置生效。

✨ 主要特性

• 协议支持：完全支持 MCP 协议。
• 流式传输：实时响应流式传输。
• 密钥处理：安全的 API 密钥处理。
• 参数配置：可配置的模型参数。
• 技术实现：采用 TypeScript 实现。

📦 安装指南

本地开发

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

# 安装依赖
npm install

# 启动开发服务器
npm run dev

📚 详细文档

• Claude Desktop 安装指南 - 详细的安装说明。
• 示例和使用方法 - 使用示例及高级配置。
• 实现细节 - 技术实现详情。
• 开发指南 - 开发人员指南。
• 故障排除指南 - 常见问题解决方案。

💻 使用示例

基础用法

暂未提供基础用法的代码示例，你可以参考 示例和使用方法 文档获取更多信息。

高级用法

暂未提供高级用法的代码示例，你可以参考 示例和使用方法 文档获取更多信息。

❓ 常见问题

连接问题

• 检查端口 3005 是否可用。
• 验证网络连接。
• 参考 故障排除指南。

API 密钥问题

• 确认 API 密钥是否正确。
• 检查权限设置。
• 参考 安装指南。

🔧 技术细节

本项目采用 TypeScript 实现，实现了 Google Gemini AI 模型与 Claude Desktop 之间基于 MCP 协议的交互。通过配置文件和环境变量来管理 API 密钥和服务器参数，确保了系统的安全性和可配置性。详细的技术实现细节可参考 实现细节 文档。

🔒 安全

• 仅通过环境变量处理 API 密钥。
• 不存储或记录任何敏感数据。
• 定期更新安全补丁。

🤝 贡献

欢迎贡献！请参考我们的 Contributing Guide。

📄 许可证

本项目采用 MIT 许可证。