MCP ChatBot

🚀 MCP-ChatBot

MCP-ChatBotは、Modular Capability Protocol (MCP) を使用して複数のサービスバックエンドとやり取りする、機能豊富なチャットボットアプリケーションです。このアプリケーションは、大規模言語モデル (LLM) が外部サービスと連携する方法を示しています。

🚀 クイックスタート

MCP-ChatBotは、Modular Capability Protocol (MCP) を使用してLLM（大規模言語モデル）が外部サービスとやり取りする方法を示すコンテナ化されたアプリケーションです。この実装には、天気サービスバックエンドとStreamlitベースのフロントエンドインターフェイスが含まれており、ユーザーは自然言語で天気情報を照会することができます。

✨ 主な機能

• コンテナ化アーキテクチャ：MCPサーバーとクライアントアプリケーションはそれぞれ独立したコンテナで実行されます。
• 天気サービス統合：WeatherAPIを使用してリアルタイムの天気データを取得します。
• Streamlit UI：チャットボットとの対話に使用する、シンプルでレスポンシブなインターフェイスです。
• 拡張可能な設計：さらなる機能を実装するために、いつでも追加のMCPサーバーを追加できます。
• GPT-4o統合：OpenAIのGPT-4oモデルによってサポートされ、自然言語理解を実現します。

🔧 技術詳細

このアプリケーションは、2つの主要なコンポーネントで構成されています。

1. MCPサーバー：FastMCPに基づくサービスで、天気データの取得を処理します。
2. Streamlitクライアント：チャットボットとの対話に使用するWebインターフェイスです。

📦 インストール

前提条件

• DockerとDocker Compose
• WeatherAPIキー（WeatherAPI で登録して取得）
• OpenAI APIキー（OpenAI で登録して取得）

手順

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/MCP-ChatBot.git
   

2. サンプル環境ファイルをコピーします。

   cp .env.example .env
   

3. Dockerサービスを起動します。

   docker-compose up --build
   

📚 ドキュメント

アプリケーションの拡張

• 新しいサーバーの追加：servers フォルダに新しいファイルを作成し、既存のサーバーの形式に従って設定を記述します。
• 設定の更新：docker-compose.yml ファイルを編集して、新しいサービス定義を追加します。

開発情報

• プロジェクト構造：

  • src/：核心ソースコードが含まれています。
  • templates/：HTMLテンプレートとUIコンポーネントが含まれています。
  • static/：静的リソースファイルが含まれています。

• 技術スタック：

  • FastMCP：MCPプロトコルの実装に使用されます。
  • Streamlit：フロントエンドインターフェイスの開発に使用されます。
  • WeatherAPI：天気データの取得に使用されます。

トラブルシューティング

• 一般的な問題：
  • DockerとDocker Composeが正しくインストールされていることを確認してください。
  • .env ファイルの設定が正しいことを確認してください。
  • 天気サービスに接続できない場合は、APIキーが有効であることを確認してください。

📄 ライセンス

このプロジェクトは、LICENSE ファイルに詳細が記載されているMITライセンスの下で提供されています。

謝辞

• FastMCP：MCPサーバーの実装を提供しています。
• Streamlit：フロントエンドフレームワークを提供しています。
• WeatherAPI：天気データを提供しています。

Murali Anand によって作成 © 2025