# mcp-server

**Repository Path**: zeus-maker/mcp-server

## Basic Information

- **Project Name**: mcp-server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-16
- **Last Updated**: 2025-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 联想智能购物助手

基于通义千问大语言模型的智能购物助手系统，专门用于推荐和介绍联想品牌产品。

## 项目架构

```
.
├── ai_shopping_assistant/     # 前端应用
│   └── src/
│       ├── app.py            # Streamlit Web应用
│       ├── config.py         # 配置文件
│       └── utils.py          # 工具函数和核心逻辑
│
├── ai_shopping_server/       # 后端服务
│   ├── sse_server.py        # SSE服务器
│   ├── mcp_server_stdio.py  # MCP服务器实现
│   └── requirements.txt     # 后端依赖
│
├── README.md                # 项目说明文档
└── pyproject.toml          # 项目依赖管理
```

## 功能特点

- 专注于联想品牌产品推荐和介绍
- 基于通义千问大语言模型的智能对话
- 实时商品搜索和推荐
- 详细的产品信息展示
- 智能购物车管理
- 个性化产品推荐
- 实时库存和价格查询
- 多维度商品对比

## 技术栈

- **前端**：
  - Streamlit：构建Web界面
  - Python 3.10+：主要开发语言
  - AsyncIO：异步IO处理
  - SSE：服务器推送事件

- **后端**：
  - FastAPI：构建API服务
  - MCP：模型调用协议
  - 通义千问API：大语言模型服务

## 安装说明

1. 克隆项目：
   ```bash
   git clone [项目地址]
   cd [项目目录]
   ```

2. 创建并激活虚拟环境：
   ```bash
   python -m venv .venv
   source .venv/bin/activate  # Linux/Mac
   # 或
   .venv\Scripts\activate  # Windows
   ```

3. 安装依赖：
   ```bash
   # 安装前端依赖
   pip install -r ai_shopping_assistant/requirements.txt
   
   # 安装后端依赖
   pip install -r ai_shopping_server/requirements.txt
   ```

4. 配置环境变量：
   ```bash
   # 设置通义千问API密钥
   export TONGYI_API_KEY=your_api_key
   ```

## 使用说明

1. 启动后端服务：
   ```bash
   cd ai_shopping_server
   python sse_server.py
   ```

2. 启动前端应用：
   ```bash
   cd ai_shopping_assistant
   streamlit run src/app.py
   ```

3. 访问应用：
   打开浏览器访问 `http://localhost:8501`

## 主要功能模块

### 1. 商品搜索
- 支持关键词搜索
- 商品分类浏览
- 高级筛选功能

### 2. 商品详情
- 详细规格参数
- 价格信息
- 库存状态
- 用户评价

### 3. 智能推荐
- 基于用户偏好的个性化推荐
- 相似商品推荐
- 热门商品推荐

### 4. 购物车管理
- 添加/删除商品
- 修改数量
- 价格计算
- 库存检查

### 5. 用户交互
- 自然语言对话
- 智能问答
- 商品对比
- 购买建议

## API说明

### 商品搜索API
```python
async def search_products(keywords: str, category: str = None, sort_by: str = "relevance")
```

### 商品详情API
```python
async def get_product_detail(product_id: str)
```

### 购物车管理API
```python
async def manage_shopping_cart(user_id: str, action: str, product_id: str = None)
```

### 智能推荐API
```python
async def get_recommendations(user_id: str, preferences: List[str] = None)
```

## 配置说明

主要配置项（config.py）：
```python
TONGYI_API_KEY = "your_api_key"  # 通义千问API密钥
TONGYI_API_BASE = "api_endpoint" # API端点
TONGYI_MODEL = "model_name"      # 模型名称
LOG_DIR = Path("logs")           # 日志目录
```

## 开发指南

### 添加新功能
1. 在utils.py中添加新的工具函数
2. 在app.py中添加对应的UI组件
3. 更新系统提示词以支持新功能
4. 添加相应的测试用例

### 代码规范
- 遵循PEP 8规范
- 使用类型注解
- 添加详细的文档字符串
- 保持代码简洁清晰

## 常见问题

1. **连接错误**
   - 检查SSE服务器是否正常运行
   - 确认网络连接状态
   - 验证API密钥是否正确

2. **响应延迟**
   - 检查网络状态
   - 确认服务器负载
   - 优化查询参数

3. **结果不准确**
   - 优化系统提示词
   - 调整搜索参数
   - 更新产品数据

## 更新日志

### v1.0.0 (2024-04-22)
- 初始版本发布
- 实现基础购物助手功能
- 集成通义千问模型
- 添加联想产品数据库

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 发起 Pull Request

## 许可证

MIT License

## 联系方式

- 项目维护者：[维护者姓名]
- 邮箱：[联系邮箱]
- 项目地址：[项目URL]