智能客户服务示例

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

特性

• 智能问答服务
• 转接到人工客服
• 订单信息查询
• 产品知识库管理

系统需求

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

安装

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

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

2. 安装依赖项：

uv pip install .

使用说明

1. 运行

• 使用标准I/O模式运行，需要以--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. 使用标准I/O方法运行检查器：

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许可证。