Smart Customer Support

🚀 スマートカスタマーサポートのサンプル

このプロジェクトは、MCPフレームワークに基づいて構築されたスマートカスタマーサポートシステムのデモです。スマートカスタマーサポートアプリケーションの構築とデプロイ方法を示すことを目的としています。

ドキュメントリンク

✨ 主な機能

• AIによる質問応答サービス
  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)