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)