🚀 天秤座 Gemini MCP 项目文档

本项目提供了一套基于Google Gemini模型的管理和处理方案，支持多模型管理、文件处理、搜索集成等功能，能有效提升复杂推理任务的处理效率。

🚀 快速开始

📦 安装依赖项

go get golang.org/x/oauth2@git://github.com/golang/oauth2/cmd/...

⚙️ 环境变量配置

▶️ 运行命令

# 初始化 Gemini MCP
go run main.go

# 启动服务
./start_service.sh

✨ 主要特性

🌟 核心功能

• 模型管理：支持多个Gemini模型，包括gemini-1.5-pro、gemini-2.0-flash等。
• 上下文缓存：启用上下文缓存，默认存储时间为1小时。
• 思考模式：支持详细思考过程，适用于复杂推理任务。
• 文件处理：支持上传最大10MB的常见文本和代码文件。

⚡ 高级功能

• 搜索集成：内置Google搜索功能，支持来源标注。
• 错误恢复：自动进入安全模式以应对初始化失败。
• 重试机制：使用指数回退策略确保API通信可靠。
• 日志记录：提供结构化日志，便于排查问题。

📚 详细文档

🎛️ 模型管理

模型优先级

1. 推荐模型：

   • 思考任务：gemini-2.5-pro
   • 缓存任务：gemini-2.0-flash
   • 搜索任务：gemini-2.0-flash

2. 版本选择：

   • 新版本优先：确保使用最新功能和性能优化。
   • 特定场景优化：针对不同任务推荐最佳模型。

⚙️ 配置优化

关键环境变量

性能调优

• 减少超时：在高延迟环境中，适当缩短超时时间。
• 调整重试策略：根据网络稳定性调节最大重试次数。
• 优化缓存：合理设置缓存过期时间，平衡命中率和新鲜度。

🛠️ 开发指南

项目结构

gemini-mcp/
├── cmd/                 # 命令行工具
│   ├── gemini_ask.go    # 对话接口
│   └── gemini_search.go # 搜索接口
├── pkg/                 # 核心包
│   ├── model_manager.go  # 模型管理器
│   ├── caching.go       # 缓存模块
│   └── search_engine.go  # 搜索引擎
└── README.md             # 项目文档

开发步骤

# 1. 初始化项目
go mod init your_project_name
go mod tidy

# 2. 运行测试
go test ./...

# 3. 代码检查
go lint ./...

# 4. 格式化代码
go fmt ./...

⚠️ 运行时注意事项

资源管理

• 内存限制：监控缓存占用，防止内存溢出。
• 磁盘空间：定期清理过期缓存，避免耗尽存储空间。

安全措施

• 密钥保护：
  • 环境变量中的API密钥需加密处理。
  • 避免将密钥写入版本控制系统。

🔄 最近变更

1. 改进模型管理：优化了多模型切换逻辑，提升了性能。
2. 增强缓存机制：引入了更智能的缓存策略，减少了重复计算。
3. 完善思考模式：增加了更多推理选项，支持复杂场景。
4. 修复已知问题：
   • 修正了文件处理中的边界条件。
   • 解决了重试机制下的死锁问题。

📄 许可证

项目遵循MIT License，欢迎自由使用和修改，但需保留版权声明。

🤝 贡献指南

如何贡献

1. ** Fork 仓库**
2. ** 提交修复或功能**
3. ** 创建 Pull Request**

贡献标准

• 遵循代码规范
• 提供详细的变更说明
• 确保单元测试通过

📋 附录

常见问题

• Q: 如何查看当前版本？ A: 执行go version即可显示项目版本。
• Q: 如何禁用缓存？ A: 设置环境变量GEMINI_ENABLE_CACHING=false。
• Q: 支持哪些文件类型？ A: 支持txt、pdf、docx等常见格式，具体取决于模型支持。