MCP ChatBot

🚀 MCP-ChatBot

MCP-ChatBot 是一個功能多樣的聊天機器人應用程序，它藉助 MCP（模塊化能力協議）與多個服務後端交互，能為用戶提供豐富的服務體驗。

🚀 快速開始

MCP-ChatBot 是一個容器化的應用程序，展示瞭如何使用 Modular Capability Protocol (MCP) 使 LLM（大語言模型）與外部服務進行交互。此實現包括天氣服務後端和一個基於 Streamlit 的前端界面，允許用戶通過自然語言查詢天氣信息。

先決條件

• 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

✨ 主要特性

• 容器化架構：MCP 服務器和客戶端應用程序分別運行在獨立的容器中
• 天氣服務集成：使用 WeatherAPI 實現即時天氣數據獲取
• Streamlit UI：乾淨、響應式界面，用於與聊天機器人交互
• 可擴展設計：隨時可以添加更多 MCP 服務器以實現更多功能
• GPT-4o 集成：由 OpenAI 的 GPT-4o 模型提供支持，實現自然語言理解

🔧 技術細節

架構

該應用程序包含兩個主要組件：

1. MCP 服務器：基於 FastMCP 的服務，負責處理天氣數據的檢索
2. Streamlit 客戶端：用於與聊天機器人交互的網絡界面

項目結構

• src/：包含核心源代碼
• templates/：包含 HTML 模板和 UI 組件
• static/：包含靜態資源文件

技術棧

• FastMCP：用於 MCP 協議實現
• Streamlit：用於前端界面開發
• WeatherAPI：用於天氣數據獲取

📚 詳細文檔

擴展應用

• 新增服務器：在 servers 文件夾中創建新文件，按照現有服務器的格式編寫配置。
• 更新配置：編輯 docker-compose.yml 文件以添加新的服務定義。

故障排除

• 常見問題：
  • 確保 Docker 和 Docker Compose 已正確安裝。
  • 檢查 .env 文件中的配置是否正確。
  • 如果無法連接到天氣服務，請檢查 API 密鑰是否有效。

📄 許可證

項目在 LICENSE 文件中詳細說明了 MIT 許可證的使用條款。

致謝

• FastMCP：提供 MCP 服務器實現
• Streamlit：提供前端框架
• WeatherAPI：提供天氣數據

由 Murali Anand 創建 © 2025