workflow-mcp

workflow-templates 저장소의 AI 워크플로 템플릿을 MCP 호출 가능 도구로 만듭니다. 모든 MCP 클라이언트(WorkBuddy, Claude Desktop, Cursor 등)가 템플릿을 직접 나열하고, 계약을 조회하며, 템플릿을 실행해 구조화된 결과를 얻을 수 있습니다.

디지털 파이프라인의 설계자 · 네 번째 블록: 모든 파이프라인을 "플러그 앤 플레이"로

할 수 있는 일

예시 세션:

1. list_templates                    → 发现 financial-report-analysis
2. get_template_info(模板id)          → 拿到输入契约（需要 company_name / report_path / report_type）
3. run_template_async(模板id, json)   → {task_id, status: running}
4. get_task_status(task_id)           → 轮询至 done，返回指标 + 风险信号 + 报告

비동기 버전이 필요한 이유: WorkBuddy / Claude Desktop 등 클라이언트는 단일 도구 호출에 요청 타임아웃 제한이 있습니다. 그런데 템플릿의 실제 실행(여러 번의 LLM 호출)은 보통 1~2분이 걸리므로, 동기 호출은 타임아웃됩니다. 비동기 버전은 이 제한을 우회합니다.

Related MCP server: MCP Boilerplate

아키텍처

MCP 客户端（WorkBuddy / Claude Desktop / ...）
        │  stdio / streamable-http
┌───────▼───────────────┐
│  server.py (FastMCP)  │   list / get / run 三个工具
└───────┬───────────────┘
┌───────▼───────────────┐
│  templates_registry.py │  扫描 workflow-templates，读取契约元数据
│  runner.py             │  子进程执行模板 run.py（--auto-review 自动化复核）
└───────┬───────────────┘
        │
┌───────▼───────────────┐
│  workflow-templates    │  模板仓库：契约 + 提示词 + 脚本（数据权威）
└───────────────────────┘

핵심 설계:

• 템플릿 저장소를 단일 진실 원천으로 유지: 템플릿 추가/수정은 workflow-templates만 변경하면 되고, 본 서비스는 변경할 필요 없음

• 자동 검증: run.py에 --auto-review 인자 추가. MCP 자동 실행 시 수동 개입을 건너뛰고, 출력에 review_note 표시를 포함해 호출 측이 핵심 수치를 검증

• 실행 격리: 실행마다 임시 입력 파일을 생성(사용 후 삭제), 출력은 템플릿의 output/에 저장

빠른 시작

pip install -e .
python -m workflow_mcp.server                 # stdio（默认）
python -m workflow_mcp.server --transport streamable-http

전제 조건: workflow-templates 저장소가 로컬 E:\NEMB\workflow-templates에 있어야 함(환경 변수 WORKFLOW_TEMPLATES_HOME으로 덮어쓸 수 있음). 템플릿에 포함된 .env(예: OpenRouter 키)는 run.py가 자동으로 로드합니다.

엔드투엔드 테스트(재무 분석 템플릿을 실제로 한 번 실행함):

python examples/client_test.py    # stdio 协议方式
python examples/inproc_test.py    # 进程内客户端方式（CI / 沙箱环境更稳）

WorkBuddy 연동

examples/workbuddy_mcp.json을 C:\Users\33033\.workbuddy\mcp.json의 mcpServers에 병합하고, 커넥터 관리 페이지에서 workflow-mcp에 대해 「신뢰」를 클릭하여 활성화합니다. 이후 대화에서 바로 "재무 분석 템플릿 실행해줘"라고 말하면 됩니다.

세 가지 구성 요소와의 관계

로드맵

• v0.1: list / get / run 세 가지 도구 + --auto-review(현재)

• v0.2: 템플릿 출력 DB 저장(결과 추적 가능), 동시 실행 큐, 실행 n8n 버전 템플릿 가져오기

• v0.3: digital-twin-mcp와 결합한 "장치 건강 보고서" 템플릿(데이터 파이프라인 × 지식 노동 파이프라인)

라이선스

MIT License