Alfred VoC Analysis MCP v0.1

Es un servidor MCP que convierte los hechos de VoC de Heum Alfred/DESK en inteligencia de CX. La estructura se divide explícitamente en Fact → Analysis → Synthesis.

Arquitectura

• fact.py: FactRepository que implementará el adaptador de DB/API; no almacena interpretación de IA en Fact.

• analysis.py: calcula la visión general, la inteligencia de incidencias, la preocupación de CX, la señal emergente, el impulsor de tendencia y el efecto de resolución con Python determinista.

• synthesis.py: combina el informe detallado, el resumen ejecutivo y el DTO de señal de planificación de mejoras.

• server.py: adaptador de herramientas FastMCP. El núcleo de análisis no depende de MCP ni de LLM externos.

El esquema de entrada es FactRecord(extra="allow"), que preserva los campos de extensión de source. No cambia el esquema real de la DB, y la conexión de producción con la DB/API se añade mediante el adaptador FactRepository.

Related MCP server: NPS Chatbot MCP Server

Herramientas 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

Las herramientas de incidencias comparten intencionalmente una única evaluación de cartera para que Frequency por sí sola no pueda contradecir Priority Movement. Cada resultado de incidencia devuelve evidence, reason y confidence.

Ejecución

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

v0.1 incluye un adaptador de referencia en memoria. Incrusta el servicio y llama a configure_records, o implementa FactRepository para la DB/API de voc-management.

Calibración

AnalysisConfig contiene ajustes de suficiencia de datos y de ventana de observación. Los valores predeterminados son valores técnicos conservadores, no una política de Heum. No se utiliza ninguna puntuación ponderada opaca ni una regla de negocio fija de “N casos=Alto”.