Gemini MCP Server Chatbot

🚀 GoogleのGeminiを使用したMCPサーバー - GeminiRouter

このプロジェクトは、モデルコンテキストプロトコル (MCP) と GoogleのGemini Flash 1.5 API を組み合わせた実装です。目的は、モジュール化されたAIサービスが集中型のルーターを通じてどのように連携するかを示すことです。

🚀 クイックスタート

システムの概要

このシステムは、ユーザーからの入力を受け取り、適切なサービスにルーティングして応答を返す仕組みになっています。以下に、システムの動作フローを説明します。

1. ユーザー入力：ユーザーがフロントエンドのUIからクエリを送信します。
2. ルーティングロジック：
   • ルーターがクエリを受け取り、意図を分析します。
   • キーワード、コンテキスト、過去の対話履歴に基づいて、ルーターは適切なサーバー（チャット、検索、RAG、思考など）を選択してクエリを処理します。
3. サービス処理：
   • チャットサーバー：対話形式または非公式なクエリの場合は、このサーバーにルーティングされ、迅速な応答が得られます。
   • 検索サーバー：リアルタイムまたは事実データが必要なクエリ（例：「スウェーデンの首都はどこですか？」）の場合は、このモジュールを通じてGemini APIが呼び出されます。
   • RAGサーバー：複雑な問題で、ドキュメントベースの知識統合が必要な場合は、RAGモジュールが検索レイヤーとGeminiを使用して回答を生成します。
   • 思考サーバー：論理的な推論または多段階の問題解決が必要な場合は、ここで深度処理が行われます。
   • 天気情報（検索経由）：検索サーバーにはOpenWeather APIが統合されており、自然言語での天気クエリ（例：「東京の天気はどうですか？」）を処理できます。
4. 応答集約：
   • 選択されたモジュールがリクエストを処理し、結果をルーターに返します。
   • ルーターは、複数のモジュールからの応答を選択的に組み合わせることができます（例：天気情報と提案を含む応答）。
5. フロントエンド出力：最終的な応答がユーザーインターフェースに返され、クリーンで対話的な形式で表示されます。

✨ 主な機能

• モジュール化されたAIサービス：チャット、検索、RAG、思考などの各機能には専用のマイクロサービスがあります。
• 集中型コンテキストルーター：すべてのサービスが集中型のルーターを通じて調整されます。
• Gemini Flash 1.5の統合：GoogleのGemini技術を利用して強力なAI機能を実現します。
• OpenWeatherの統合：天気情報のクエリ機能を提供します。

📦 インストール

クローン

git clone https://github.com/your-repository.git
cd GeminiRouter

バックエンドの起動

npm install
npm start

フロントエンドの起動

cd frontend
npm install
npm run dev

📚 ドキュメント

プロジェクト構造

.
├── src/
│   ├── router/         # ルーターのロジック
│   ├── services/      # 各サービスモジュール
│   └── components/    # フロントエンドコンポーネント
└── package.json       # プロジェクトの依存関係とスクリプト

未来計画

• Docker Composeへのフロントエンド統合：フロントエンドとバックエンドのサービスを統一管理できるようにします。
• ユーザーインターフェース (UI) の改善：より多くのインタラクティブな機能を追加し、ユーザー体験を向上させます。
• API統合の拡張：天気、ニュースなどの他のデータソースを統合します。

🔧 技術詳細

MCPの仕組み

モデルコンテキストプロトコル (MCP) は、複数の専用AIエージェントまたはサービス間でモジュール化されたコンテキスト感知型通信を実現するためのアーキテクチャパターンです。このプロジェクトでは、MCPの原理を応用して、拡張可能でスマートなAIシステムを構築しています。このシステムは、専用のマイクロサービスを持ち、中心的なルーターによって調整されます。

各サービス（または「コンテキスト」）は、チャット、ウェブ検索、天気情報、深度推論、または検索強化生成 (RAG) などの特定の機能を実行し、軽量なリクエストを通じて ルーター/クライアント 間で通信します。

🔑 注意事項

⚠️ 重要提示

このプロジェクトはGeminiとOpenWeatherのサービスにアクセスするためにインターネット接続が必要です。使用前に、以下のAPIキーを設定してください。

# 環境変数に設定
export GEMINI_API_KEY=your_key_here
export OPENWEATHER_API_KEY=your_key_here

💡 使用建议

デバッグが必要な場合は、以下のコマンドを実行してください。

npm run debug

GeminiRouterを通じて、モジュール化されたAIサービスの実用的な可能性を実証しました。チャット、検索、天気クエリなど、すべてを手の届くところに！