Smart Customer Support

🚀 Smart Customer Service Example

This is a demonstration project of an intelligent customer service system built on the MCP framework. It aims to show how to build and deploy an intelligent customer service application.

Documentation Link

🚀 Quick Start

This project is a demonstration of an intelligent customer service system built on the MCP framework, aiming to showcase the process of building and deploying intelligent customer service applications.

✨ Features

• Intelligent Q&A Service: Offers AI-based question-and-answer functionality.
• Human Customer Service Transfer: Supports automatically transferring user questions to human customer service.
• Order Information Query: Allows users to query order status and related information.
• Product Knowledge Base Management: Provides management and maintenance functions for the product-related knowledge base.

📦 Installation

System Requirements

• Python version >= 3.10
• MCP framework version >= 1.6.0

Steps

1. Create and activate a virtual environment (recommended):

uv venv 
source .venv/bin/activate  # For Linux/macOS systems

2. Install dependencies:

uv pip install .

💻 Usage Examples

Basic Usage

Running Modes

• Run in stdio mode: Start with the --stdio parameter.

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

Or directly use:

python start.py --stdio

• Run in sse mode: The default port is 9000, and it can be started without additional parameters.

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

Or directly use:

python start.py 

Use inspector in stdio mode

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

Use in desktop applications like Vscode or Claude

Configure the following content in the settings file:

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

Advanced Usage

Add environment variable configuration

{
    "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"
            }
        }
    }
}  

🔧 Technical Details

Project Architecture

src/mcp_smart_customer_support/
├── __init__.py          # Package initialization file
├── mcp_server.py        # Core implementation of the MCP server
├── human_customer_service.py  # Human customer service processing module, responsible for handling customer service-related logic
├── order_operations.py  # Functions related to order operations, used for querying and managing order information
└── product_knowledge.py # Product knowledge base management module, maintaining product-related information

Author

ggguo (admin@precariat.tech)

📄 License

This project is licensed under the MIT License.