Smart Customer Support

🚀 智能客服示例

这是一个基于MCP框架构建的智能客服系统演示项目，能够展示如何搭建和部署智能客服应用程序，为用户提供便捷的客服服务。

文档链接

🚀 快速开始

本项目基于MCP框架构建，旨在展示智能客服系统的搭建与部署。下面将为你介绍系统要求、安装步骤和使用方法。

✨ 主要特性

• 智能问答服务：提供基于AI的问答功能，快速响应常见问题。
• 人工客服转接：支持自动将用户问题转接到人工客服，确保复杂问题得到妥善解决。
• 订单信息查询：允许用户查询订单状态及相关信息，提升购物体验。
• 产品知识库管理：提供对产品相关知识库的管理和维护功能，方便更新产品信息。

📦 安装指南

环境准备

• Python版本 >= 3.10
• MCP框架版本 >= 1.6.0

安装步骤

1. 创建并激活虚拟环境（推荐）：

uv venv 
source .venv/bin/activate  # 适用于Linux/macOS系统

2. 安装依赖项：

uv pip install .

💻 使用示例

基础用法

运行方式

• 以stdio模式运行：需要通过--stdio参数启动

uv --directory /opt/apps/python_project/SmartCustomerSupportMCP run mcp-smart-customer-support --stdio

或者直接使用：

python start.py --stdio

• 以sse模式运行：默认端口为9000，无需额外参数即可启动

uv --directory /opt/apps/python_project/SmartCustomerSupportMCP run mcp-smart-customer-support

或者直接使用：

python start.py 

以stdio模式使用inspector

npx @modelcontextprotocol/inspector uv --directory /opt/apps/python_project/SmartCustomerSupportMCP run mcp-smart-customer-support --stdio

在Vscode或Claude等桌面应用中使用

配置如下内容到设置文件中：

{
    "mcpServers": {
        "SmartCustomerSupportMCP": {
            "command": "uv",
            "args": [
                "--directory",
                "/opt/apps/python_project/SmartCustomerSupportMCP", 
                "run",
                "mcp-smart-customer-support",
                "--stdio"
            ]
        }
    }
}    

高级用法

增加环境变量配置

{
    "mcpServers": {
        "SmartCustomerSupportMCP": {
            "command": "uv",
            "args": [
                "--directory",
                "/opt/apps/python_project/SmartCustomerSupportMCP", 
                "run",
                "mcp-smart-customer-support",
                "--stdio"
            ],
            "env": {
                "MYSQL_HOST": "192.168.xxx.xxx",
                "MYSQL_PORT": "3306",
                "MYSQL_USER": "root",
                "MYSQL_PASSWORD": "root",
                "MYSQL_DATABASE": "a_llm",
                "MYSQL_ROLE": "admin"
            }
        }
    }
}  

🔧 技术细节

项目架构

src/mcp_smart_customer_support/
├── __init__.py          # 包初始化文件
├── mcp_server.py        # MCP服务器核心实现
├── human_customer_service.py  # 人工客服处理模块，负责处理与客服相关的逻辑
├── order_operations.py  # 订单操作相关功能，用于查询和管理订单信息
└── product_knowledge.py # 产品知识库管理模块，维护产品相关信息

📄 许可证

本项目采用MIT许可证。

👨‍💻 作者

ggguo (admin@precariat.tech)