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