Geminimcp

🚀 天秤座 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等常見格式，具體取決於模型支持。