Skip to main content
Glama
GYINT

QCM MCP Server

by GYINT

QCM · Quality Crisis Management

품질 문제 해결 Skill. v1.0.0 릴리스 버전 · 「위기 대응 + 시스템 거버넌스 평가 + 지식 축적」을 재사용 가능한 문제 해결 파이프라인으로 캡슐화.

Status Version Tests License


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×복잡도)

🛡️ 방어적 출력

[unverified] 표기 + 데이터 유효기간 + 경계 선언 + 재진술 금지

🤝 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.md

2. 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 환경에서는 commandpython3 + args: ["스크립트 경로", "--transport", "stdio"]로 변경하세요.

도구 목록(10개):

  • 문제 해결 코어 6개: qcm_research / qcm_decide / qcm_solve_problem / qcm_score_source / qcm_audit / qcm_validate

  • Infoseek 협업 3개: qcm_attribution / qcm_attribution_phase / qcm_gap_detect

  • 플러그인 확장 1개: qcm_plugin_echo(핫 로드 예시)

3. 환경 변수

변수

용도

기본값

QCM_ROOT

QCM 설치 루트(경로 정규화)

자체 추론

INFOSEEK_ROOT

Infoseek 설치 루트(크로스 Skill 협업)

탐지 목록

QCM_KEYWORDS

키워드 사전 경로 오버라이드

references/config/keyword.yaml

QCM_AUTH_TOKEN

MCP 인증 토큰


문서 탐색

문서

용도

SKILL.md

Skill 전체 정의(개념/능력/트리거 단어)

version_history.md

외부 버전 이력

DEPENDENCIES.md

외부 의존성 목록 + 역할 + 폴백 경로

API_KEYS.md

외부 API Key 목록 + 효용(실제 키 값 미포함)

references/protocol/action-orders.md

14장 프로토콜 권위

references/contract/

입력 계약(mds-input + 가이드)

references/config/

키워드 사전 + 라우팅 + 컴포넌트 구성

docs/CHANGELOG.md

버전 변경 로그

docs/INSTALL.md

설치 가이드

docs/TROUBLESHOOTING.md

장애 해결

tests/

테스트 스위트(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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    Enterprise-grade MCP framework for building production-ready AI tools with data quality, security, audit trails, and comprehensive testing.
    68
    Business Source 1.1
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables 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.
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables 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.
    -