workflow-mcp

Превращает шаблоны AI-рабочих процессов из репозитория workflow-templates в инструменты, вызываемые через 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: сохранение выходных данных шаблонов в базу (результаты отслеживаемы), очередь конкурентного выполнения, импорт шаблонов из n8n

• v0.3: комбинирование с digital-twin-mcp в шаблон "отчёт о состоянии устройства" (конвейер данных × конвейер умственного труда)

Лицензия

MIT License