sangfor-mcp-workflow

Sangfor Engineer MCP Workflow Automation — 3대 핵심 워크플로우 자동화

개요

이 프로젝트는 sangfor-engineer-mcp의 워크플로우 자동화 레이어입니다.

3대 핵심 워크플로우

워크플로우	목적	상태
① 프로젝트 올인원	Excel → 가이드 → 검증 → 보고서 자동화	🔴 개발 예정
② 실장비 일상 점검	정기 정책 상태 확인 + 이상 감지	🔴 개발 예정
③ Obsidian 연동	피드백 → 교훈 → 위키 자동 반영	🔴 개발 예정

설치

corepack enable
pnpm install

실행

# MCP 서버 실행
pnpm run dev:mcp

# 웹 UI 실행
pnpm run dev:web

# 프로젝트 파이프라인 실행
pnpm run pipeline:run -- --excel ./path/to/checklist.xlsx --customer "고객사명"

# 실장비 점검 실행
pnpm run health:check -- --product EPP --target https://10.80.1.106

# Obsidian 동기화 실행
pnpm run wiki:sync -- --vault ~/Documents/Obsidian\ Vault/

구조

sangfor-mcp-workflow/
├── apps/
│   ├── mcp-server/          # MCP stdio JSON-RPC 서버
│   └── operator-console/    # 웹 UI + REST API
├── packages/
│   ├── workflow-core/       # 워크플로우 엔진 (파이프라인, 스케줄러)
│   ├── health-checker/      # 실장비 점검 모듈
│   ├── wiki-sync/           # Obsidian/GitHub Wiki 동기화
│   └── shared/              # 공통 타입 및 유틸리티
├── tests/                   # Vitest 테스트
├── scripts/                 # 실행 스크립트
└── docs/                    # 문서

기술 스택

영역	기술
언어/런타임	TypeScript, Node.js 22
모노레포	pnpm workspace
테스트	Vitest
MCP 서버	stdio JSON-RPC
웹 프레임워크	Express (선택)
실장비 제어	Playwright CDP
지식 관리	Obsidian, GitHub Wiki

개발 가이드

새 워크플로우 추가

1. packages/ 아래에 새 패키지 생성
2. packages/workflow-core/src/에 워크플로우 정의
3. apps/mcp-server/src/index.ts에 MCP tool 등록
4. tests/에 테스트 코드 작성
5. scripts/에 실행 스크립트 추가

테스트

# 전체 테스트
pnpm test

# 특정 패키지 테스트
pnpm test --filter @sangfor/workflow-core

# 워치 모드
pnpm test:watch

라이선스

MIT