智能客服示例

这是一个基于MCP框架构建的智能客服系统演示项目，旨在展示如何搭建和部署智能客服应用程序。

文档链接

功能特点

• 智能问答服务
  提供基于AI的问答功能。
• 人工客服转接
  支持自动将用户问题转接到人工客服。
• 订单信息查询
  允许用户查询订单状态及相关信息。
• 产品知识库管理
  提供对产品相关知识库的管理和维护功能。

系统要求

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

安装指南

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

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

2. 安装依赖项：

   uv pip install .
   

使用方法

1. 运行方式：

   • 以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 
     

2. 以stdio模式使用inspector：

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

3. 在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 # 产品知识库管理模块，维护产品相关信息

作者

ggguo (admin@precariat.tech)

许可证

本项目采用MIT许可证。