🚀 双子星MCPサーバー - 双子星Flash 1.5 APIを使用したGeminiRouter

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

🧐 MCPとは何で、ここではどのように機能するのか？

モデルコンテキストプロトコル（MCP） は、複数の専門化された人工知能エージェントまたはサービスが軽量なリクエストを通じてモジュール化されたコンテキスト感知型の通信を行えるようにするアーキテクチャパターンです。このプロジェクトでは、MCPの原則を活用して、専用のマイクロサービスを備え、中央ルーターによって調整される拡張可能でスマートなAIシステムを構築しています。

各サービス（または「コンテキスト」）、つまりチャット、ウェブ検索、天気情報、深層推論、または検索強化生成（RAG）などの特定の機能を実行し、軽量なリクエストを通じて通信します。これらのリクエストはすべて、ルーター/クライアント によってスマートにルーティングされます。

↺ ワークフローの概要

以下は、システムが入力から出力までどのように機能するかの説明です。

1. ユーザー入力：ユーザーがフロントエンドUIからクエリを送信します。

2. ルーティングロジック：

   • ルーターがクエリを受け取り、意図を分析します。
   • キーワード、コンテキスト、または過去の対話に基づいて、適切なサーバー（チャット、検索、RAG、思考など）を選択してクエリを処理します。

3. サービス処理：

   • チャットサーバー：クエリが対話的または非公式な性質の場合、ここにルーティングされて迅速な応答を得ます。
   • 検索サーバー：リアルタイムまたは事実データが必要なクエリ（例：「スウェーデンの首都はどこですか？」）の場合、ルーターはこのモジュールを通じて双子星APIを呼び出します。
   • RAGサーバー：ドキュメントまたは外部知識に基づいた総合的な回答が必要な複雑な質問の場合、RAGモジュールは検索層と双子星を使用して回答を生成します。
   • 思考サーバー：論理推論または多段階の問題解決が必要なクエリは、ここに渡されて深層思考処理が行われます。
   • 天気（検索経由）：検索サーバーは、OpenWeather APIと統合されており、「東京の天気はどうですか？」などの自然言語の天気クエリを処理します。

4. 応答集約：

   • 選択されたモジュールがリクエストを処理し、その応答をルーターに送信します。
   • ルーターは、必要に応じて複数のモジュールからの応答を組み合わせることができます。

5. フロントエンド出力：最終的な応答がユーザーインターフェースに返され、きれいな対話形式で表示されます。

✨ 主な機能

• モジュール化されたAIサービス
• 中央コンテキストルーター
• 双子星Flash 1.5 APIの統合
• 拡張しやすいアーキテクチャ
• 高性能な処理

🔧 前提条件

このプロジェクトを実行するには、以下の環境が必要です。

• オペレーティングシステム：Linux/macOS/Windows
• プログラミング言語：Python 3.8+
• 依存関係：
  • python-dotenv
  • requests

📋 環境変数

.envファイルを作成し、以下の内容を追加してください。

GEMINI_API_KEY=your_api_key_here
OPENWEATHER_API_KEY=your_api_key_here

🏷️ プロジェクト構造

gemini-router/
├── router.py          # メインルーターロジック
├── services/         # 各サービスモジュール
│   ├── chat_service.py
│   ├── search_service.py
│   ├── rag_service.py
│   └── weather_service.py
└── config/           # 設定ファイルと環境変数の処理
    ├── settings.py
    └── .env

📦 インストール

📥 依存関係のインストール

pip install python-dotenv requests

🔧 サーバーの起動

python router.py

🚀 将来の計画

• 自動スケーリング機能の実装
• より多くの天気APIのサポート
• ログ記録とモニタリングの追加
• グラフィカル管理インターフェースの開発

📌 注意事項

• 設定ファイル.env内のキーは、実際のAPIキーに置き換える必要があります。
• デバッグ時には、開発者ツールを使用してデバッグしてください。

🚀 双子星MCPサーバープロジェクトドキュメント完了