Alfred VoC Analysis MCP v0.1

这是一个将Heum Alfred/DESK VoC事实转换为CX intelligence的MCP服务器。结构明确分为Fact → Analysis → Synthesis。

架构

• fact.py：DB/API适配器将实现的FactRepository；Fact不存储AI解释。

• analysis.py：使用确定性Python计算overview、issue intelligence、CX concern、emerging signal、trend driver、resolution effect。

• synthesis.py：组合详细Report、Executive Brief、改进Planning Signal DTO。

• server.py：FastMCP tool adapter。分析核心不依赖MCP或外部LLM。

输入模式通过FactRecord(extra="allow")保留source扩展字段。实际不修改DB模式，通过FactRepository adapter添加production DB/API连接。

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

Issue工具特意共享一个组合评估，因此Frequency单独不能与Priority Movement相矛盾。每个issue结果都返回evidence、reason和confidence。

运行

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

v0.1附带一个内存参考适配器。嵌入服务并调用configure_records，或为voc-management DB/API实现FactRepository。

校准

AnalysisConfig包含数据充分性和观察窗口设置。默认值是保守的技术默认值，而非Heum策略。不使用不透明的加权分数或固定的“N件=High”业务规则。