README.md

---
title: LLM-Agent-Chatbot-MCP
emoji: 🚀
colorFrom: yellow
colorTo: purple
python_version: 3.12
sdk: streamlit
sdk_version: "1.44.1"
app_file: app.py
pinned: false
short_description: An Agentic Framework with MCP Tools for Complex Reasoning 
tags:
- LLM
- Agent
- MCP
---

# LLM-Agent-Chatbot-MCP

一个基于MCP（Model Context Protocol）的智能体框架，提供复杂的推理能力和多种MCP工具集成。

## 🚀 特性

- **MCP服务器集成**: 包含多个专用MCP服务器
- **智能体框架**: 基于LangGraph的智能体系统
- **Streamlit界面**: 现代化的Web用户界面
- **多模型支持**: 支持OpenAI、Anthropic等多种LLM
- **工具管理**: 自动工具发现和注册

## 🏗️ 项目结构

```
.
├── app.py                          # 主Streamlit应用
├── config.json                     # MCP服务器配置
├── python-services/                # MCP服务器目录
│   ├── service1/                   # RequestProcessor MCP服务器
│   │   ├── mcp_server.py          # MCP服务器实现
│   │   └── requirements.txt       # 依赖文件
│   ├── service2/                   # DataAnalyzer MCP服务器
│   │   ├── mcp_server.py          # MCP服务器实现
│   │   └── requirements.txt       # 依赖文件
│   └── service3/                   # MathComputer MCP服务器
│       ├── mcp_server.py          # MCP服务器实现
│       └── requirements.txt       # 依赖文件
├── mcp_server_time.py             # 时间服务MCP服务器
└── requirements.txt                # 主应用依赖
```

## 🔧 MCP服务器

### 1. RequestProcessor
- **功能**: 通用请求处理和数据分析
- **工具**: 请求处理、数据验证、服务信息

### 2. DataAnalyzer  
- **功能**: 数据分析和统计计算
- **工具**: 数据分析、统计计算、结构分析

### 3. MathComputer
- **功能**: 数学计算和统计函数
- **工具**: 基本运算、高级统计、百分位数计算

### 4. TimeService
- **功能**: 时区和时间服务
- **工具**: 多时区时间查询

## 🚀 快速开始

### 安装依赖
```bash
pip install -r requirements.txt
cd python-services/service1 && pip install -r requirements.txt
cd ../service2 && pip install -r requirements.txt  
cd ../service3 && pip install -r requirements.txt
```

### 启动应用
```bash
python app.py
```

应用将在 http://localhost:8501 启动，自动加载所有MCP服务器。

## 📖 详细文档

- [MCP服务器说明](python-services/MCP_README.md)
- [Docker部署指南](DOCKER_README.md)

## 🔮 扩展

可以基于现有MCP服务器模板创建更多专用服务，如：
- 文件处理服务
- 数据库查询服务
- 外部API集成服务
- 机器学习推理服务