Geminimcp

🚀 天秤座Gemini MCPプロジェクトドキュメント

このプロジェクトは、Google Gemini APIを利用した高度な機能を提供するアプリケーションです。複数のGeminiモデルを管理し、コンテキストキャッシュや思考モードなどの機能を備えています。

🚀 クイックスタート

📦 インストール

依存関係をインストールするには、以下のコマンドを実行してください。

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

⚙️ 環境変数の設定

以下の環境変数を設定する必要があります。

▶️ 実行コマンド

以下のコマンドを使用して、プロジェクトを初期化し、サービスを起動します。

# Gemini MCPを初期化
go run main.go

# サービスを起動
./start_service.sh

✨ 主な機能

🔑 コア機能

• モデル管理：gemini-1.5-pro、gemini-2.0-flashなど、複数のGeminiモデルをサポートします。
• コンテキストキャッシュ：コンテキストキャッシュが有効になっており、デフォルトの保存期間は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などの一般的な形式がサポートされており、具体的なサポートはモデルによって異なります。