Skip to main content
Glama
alfred-voc-analysis-mcp

alfred-voc-analysis-mcp

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».

Available Tools

14 tools
analyze_customer_experienceD

Inputs: end_date (required), start_date (required). Returns: result

analyze_issue_frequencyD

Inputs: end_date (required), start_date (required). Returns: result

analyze_issue_persistenceD

Inputs: end_date (required), start_date (required). Returns: result

analyze_issue_severityD

Inputs: end_date (required), start_date (required). Returns: result

analyze_resolution_effectD

Inputs: end_date (required), start_date (required). Returns: result

analyze_unresolved_issuesD

Inputs: end_date (required), start_date (required). Returns: result

build_executive_briefD

Inputs: end_date (required), start_date (required). Returns: object

build_improvement_signalsD

Inputs: end_date (required), start_date (required). Returns: object

build_report_datasetD

Inputs: end_date (required), start_date (required). Returns: object

compare_issue_portfolioD

Inputs: end_date (required), start_date (required). Returns: result

detect_emerging_signalsD

Inputs: end_date (required), start_date (required). Returns: result

get_voc_overviewD

Inputs: end_date (required), start_date (required), domain, channel, +3 more. Returns: object

rerank_issue_prioritiesD

Inputs: end_date (required), start_date (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools are clearly separated by specific modifiers (frequency, severity, persistence, resolution effect), but a few pairs could be confused, such as analyze_unresolved_issues vs analyze_issue_persistence and detect_emerging_signals vs analyze_voc_trends.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern using predictable verbs like get, analyze, rerank, compare, detect, and build. The repeated analyze_ prefix is systematic and applied to distinct analytical dimensions.

    Tool Count5/5

    14 tools is well within the ideal 3-15 range for a specialized VOC analysis server. The set balances analytical tools, prioritization, comparison, and reporting outputs without unnecessary fragmentation.

    Completeness5/5

    The tool surface covers the full analytical workflow: overview, issue metrics, priorities, portfolio comparison, trends, emerging signals, resolution effectiveness, and report generation. There are no obvious gaps that would leave an agent unable to complete a VOC analysis task.

    Related MCP Connectors

    Related MCP Servers