Alfred VoC Analysis MCP v0.1

Это MCP-сервер, который преобразует факты Heum Alfred/DESK VoC в CX-аналитику. Структура явно разделена на Fact → Analysis → Synthesis.

Архитектура

• fact.py: FactRepository, который реализуют адаптеры БД/API; в Fact не сохраняется AI-интерпретация.

• analysis.py: вычисляет обзор, аналитику проблем, CX-риски, зарождающиеся сигналы, драйверы трендов и эффект от устранения проблем с помощью детерминированного Python.

• synthesis.py: собирает подробный отчёт, Executive Brief и DTO сигналов для улучшений.

• server.py: адаптер инструментов FastMCP. Ядро анализа не зависит от MCP или внешних LLM.

Входная схема — FactRecord(extra="allow"), что сохраняет расширенные поля источника. Фактическая схема БД не изменяется; подключение к production БД/API добавляется через адаптер FactRepository.

Related MCP server: NPS Chatbot MCP Server

Инструменты MCP

• get_voc_overview

• analyze_issue_frequency, analyze_issue_severity, analyze_issue_persistence

• analyze_unresolved_issues, rerank_issue_priorities, compare_issue_portfolio

• analyze_customer_experience

• detect_emerging_signals

• analyze_voc_trends

• analyze_resolution_effect

• build_report_dataset, build_executive_brief, build_improvement_signals

Инструменты для проблем намеренно используют единую оценку портфеля, чтобы частота сама по себе не могла противоречить движению приоритетов. Каждый результат по проблеме возвращает evidence, reason и confidence.

Запуск

python -m venv .venv
pip install -e ".[dev]"
pytest
alfred-voc-analysis-mcp

В v0.1 поставляется эталонный адаптер в памяти. Встройте сервис и вызовите configure_records или реализуйте FactRepository для БД/API управления VoC.

Калибровка

AnalysisConfig содержит настройки достаточности данных и окна наблюдения. Значения по умолчанию — консервативные технические значения по умолчанию, а не политика Heum. Не используется непрозрачный взвешенный балл или фиксированное бизнес-правило вида «N건 = High».