QCM MCP Server
QCM · Quality Crisis Management
품질 문제 해결 Skill. v1.0.0 릴리스 버전 · 「위기 대응 + 시스템 거버넌스 평가 + 지식 축적」을 재사용 가능한 문제 해결 파이프라인으로 캡슐화.
5초 요약
# MCP server(10 工具:问题解决核心 6 + Infoseek 协同 3 + 插件 1)
python scripts/mcp_server.py输入场景 → 协议匹配(action-orders 14 章)→ 场景路由(意图×领域)→ 4 形态输出
案例应用 / 决策卡片 / 评估报告 / 快速响应(防御性标注 + 缺口协同)Related MCP server: LogicMCP Server
🎉 v1.0.0 릴리스 하이라이트
기능 | 설명 |
🏗️ 4계층 아키텍처 | 출력/프로토콜/입력/기반 엄격 분리 + 검증 계층 + 협업 계층(5개 패러다임 관통) |
📜 14장 프로토콜 권위 | action-orders.md 단일 권위: AO 카드 / 위기 관리 / 트리거 매트릭스 / 이중 폐쇄 루프 / 거버넌스 4계층 |
🧭 시나리오 라우팅 소비 | 의도 × 도메인 → 형태 × 컴포넌트 동적 조합(신뢰도 게이트 + 미적중 폴백) |
🧩 컴포넌트 풀 3대 메커니즘 | 정규화 등록(용량 제약) + 등급 분류(new/active/stable) + 제약 매핑(의도×D×복잡도) |
🛡️ 방어적 출력 |
|
🤝 Infoseek 협업 | 5차원 갭 트리거 + 하이브리드 전략 3단계 + L0→L3 단계적 폴백(선택 의존성) |
✅ 회귀 테스트 전체 통과 | 38개 스위트 PASS + 검증기 96/96 + 가드 9/9 문제 없음 |
빠른 시작
1. 설치 / 업그레이드
pip install -r requirements.txt # 核心依赖(PyYAML)
pip install -r requirements-optional.txt # 可选能力(LLM / GraphQL / OTel 等)
# 完整依赖说明见 DEPENDENCIES.md2. MCP 통합
프로젝트에서 .mcp.json(듀얼 서버 구성, Claude/Codex 등 클라이언트에서 직접 로드 가능)을 제공합니다:
{
"mcpServers": {
"qcm-search": {
"command": "${QCM_ROOT}/scripts/mcp_server.py",
"args": ["--transport", "stdio"],
"env": {
"QCM_ROOT": "${QCM_ROOT}",
"QCM_AUTH_TOKEN": "${QCM_AUTH_TOKEN}"
}
},
"infoseek-search": {
"command": "${INFOSEEK_ROOT}/scripts/infoseek_mcp_server.py",
"args": ["--transport", "stdio"],
"env": {
"INFOSEEK_ROOT": "${INFOSEEK_ROOT}"
}
}
}
}💡 Windows 환경에서는
command를python3+args: ["스크립트 경로", "--transport", "stdio"]로 변경하세요.
도구 목록(10개):
문제 해결 코어 6개:
qcm_research/qcm_decide/qcm_solve_problem/qcm_score_source/qcm_audit/qcm_validateInfoseek 협업 3개:
qcm_attribution/qcm_attribution_phase/qcm_gap_detect플러그인 확장 1개:
qcm_plugin_echo(핫 로드 예시)
3. 환경 변수
변수 | 용도 | 기본값 |
| QCM 설치 루트(경로 정규화) | 자체 추론 |
| Infoseek 설치 루트(크로스 Skill 협업) | 탐지 목록 |
| 키워드 사전 경로 오버라이드 | references/config/keyword.yaml |
| MCP 인증 토큰 | — |
문서 탐색
문서 | 용도 |
Skill 전체 정의(개념/능력/트리거 단어) | |
외부 버전 이력 | |
외부 의존성 목록 + 역할 + 폴백 경로 | |
외부 API Key 목록 + 효용(실제 키 값 미포함) | |
14장 프로토콜 권위 | |
입력 계약(mds-input + 가이드) | |
키워드 사전 + 라우팅 + 컴포넌트 구성 | |
버전 변경 로그 | |
설치 가이드 | |
장애 해결 | |
테스트 스위트(38개, run_all.py 집계) |
버전 로드맵
버전 | 상태 | 비고 |
v1.0.0 | 🟢 현재 릴리스 버전 | 버전 통일 · 4계층 아키텍처 · 14장 프로토콜 · 시나리오 라우팅 소비 · 컴포넌트 풀 3대 메커니즘 |
0.0.0-pre | ✅ 이력 | 릴리스 전 베이스라인(기존 내부 V8.3.1 체계, docs/CHANGELOG.md에 이력 보관) |
이후 | 🟡 예정 | 키워드 사전 적중률 최적화 · suggest_research 연동 · 업계 지식 패키지 확장 |
테스트 매트릭스
⚠️ 테스트 케이스 수는 각 스위트 자체 보고(PASS 집계) 기준입니다. 실행 진입점:
python tests/run_all.py(스크립트 스타일, pytest 아님).
스위트 그룹 | 스위트 수 | 카테고리 |
engines(8) | q_all / cross / loop / super / combo / full / reverse / lowfreq | 엔진 회귀 |
basic(20) | qcm_mcp v0.1→v0.9 시리즈 | MCP 프로토콜 + 기능 진화 |
protocol(8) | v1.1→v1.6 시리즈(GraphQL / OTel / WS / 이중 채널) | 고급 프로토콜 |
메인 테스트(2) | qcm_v82_test(27개 케이스) / qcm_router_golden_test(15개 케이스) | 시나리오 라우팅 + 모호성 회귀 |
환경 차이 설명:
v021(LLM Key 필요)과v071(Infoseek ws 제거됨)은 환경 미비 시 자동 SKIP, FAIL로 오보하지 않음;v131/v151은 OTel 의존성 필요(env_restore.sh --deps로 원클릭 복원).
프로젝트 구조
QCM/
├── SKILL.md # Skill 定义(yfm + 文档)
├── manifest.yaml # 平台 manifest
├── skill_meta.json # 元数据(版本/范式/维度/输出形态)
├── README.md # 本文件
├── version_history.md # 版本历史
├── DEPENDENCIES.md # 依赖声明
├── API_KEYS.md # Key 声明(不含真实值)
├── core/ # 核心库(路由/组装/验证/组件扫描/缺口检测)
│ ├── router.py # 场景路由(意图×领域 → 形态×组件)
│ ├── assembler.py # 输出组装(母模板锚点提取)
│ ├── validator.py # 4 形态验证器(96/96)
│ ├── component_scan.py # 组件热度分级
│ └── gap_detector.py # 5 维缺口检测
├── scripts/ # 适配层 + MCP server + 工具模块
│ ├── mcp_server.py # MCP server 门面(10 工具)
│ ├── infoseek_bridge.py # QCM↔Infoseek 归因桥(L0→L3 降级)
│ ├── sync_manifest.py # 双绑校验
│ ├── config_sync.py # 守卫 9 检
│ └── ...
├── references/ # 协议 + 契约 + 词库 + 配置 + 索引
│ ├── protocol/action-orders.md # 14 章协议权威
│ ├── contract/ # mds-input + 输入指引
│ ├── config/ # keyword/entities/components/constraint 等 10 配置
│ └── index/ # cases/knowledge-base/masters/tools 索引
├── components/ # 组件池(28 组件,索引自动生成勿手改)
├── outputs/ # 4 形态模板(唯一真源)
├── plugins/ # 插件扩展(热加载)
├── deploy/ # 部署资产(docker/k8s/monitoring/api)
├── docs/ # CHANGELOG / INSTALL / TROUBLESHOOTING / eval
└── tests/ # 38 套件(basic/protocol/engines + 主测试)기여 및 피드백
Bug 리포트:
qcm --version(또는 server 시작 로그) + 최소 재현 시나리오 첨부프로토콜 이슈: 관련 action-orders 장 번호 첨부
기능 요청: 사용 사례 + 기대 출력 형태 첨부
테스트 실패:
python tests/run_all.py실행 후 전체 출력 첨부
v1.0.0 | 4계층 아키텍처 · 14장 프로토콜 · 4가지 형태 · 시나리오 라우팅 소비 · 컴포넌트 풀 3대 메커니즘 | 전 산업군 품질 위기 관리 | Apache-2.0 License
This server cannot be deployed
Maintenance
Related MCP Connectors
10,065 source-verified compliance nodes, 39 pillars, 25 MCP tools (EU AI Act, GDPR, NIST, MITRE).
36 MCP tools for projects, tasks, workers, QR/NFC tags, and AI remediation. Task. Scan. Done.
Governed retail, FMCG, and CPG operational tools: runs, cases, approvals, audit-ready execution.
EU compliance corpus across 8 frameworks (NIS2, DORA, AI Act, ISO 27001 + more) via MCP.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnterprise-grade MCP framework for building production-ready AI tools with data quality, security, audit trails, and comprehensive testing.68Business Source 1.1
- FlicenseNot gradedqualityCmaintenanceEnables traceable requirement discovery, technical alignment, and ISO-aligned process checking through deterministic MCP tools and resources, without requiring an embedded LLM.1-
- FlicenseNot gradedqualityBmaintenanceEnables querying quality procedures in natural language, retrieving relevant passages via RAG, and calculating supplier KPIs such as PPM and non-conformity rates through MCP-exposed tools.-
- FlicenseNot gradedqualityCmaintenanceEnables DORA-compliant ICT contract management through 10 MCP tools, including mandatory clause checking, critical/important function analysis, subcontracting chain assessment, exit readiness evaluation, and risk scoring.-