workflow-mcp

Convierte las plantillas de flujo de trabajo de IA del repositorio workflow-templates en herramientas invocables vía MCP—cualquier cliente MCP (WorkBuddy, Claude Desktop, Cursor, etc.) puede listar plantillas, consultar contratos, ejecutar plantillas y obtener resultados estructurados.

Arquitecto de canalizaciones digitales · Cuarto bloque: hacer que todas las canalizaciones sean «plug and play»

Qué puede hacer

Sesión de ejemplo:

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，返回指标 + 风险信号 + 报告

¿Por qué se necesita la versión asíncrona? Clientes como WorkBuddy / Claude Desktop tienen límites de tiempo de espera de solicitud para una única llamada a herramienta, mientras que la ejecución real de una plantilla (múltiples llamadas al LLM) suele tardar 1-2 minutos; la llamada síncrona agotaría el tiempo de espera. La versión asíncrona evita esa limitación.

Related MCP server: MCP Boilerplate

Arquitectura

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    │  模板仓库：契约 + 提示词 + 脚本（数据权威）
└───────────────────────┘

Diseño clave:

• El repositorio de plantillas mantiene una única fuente de verdad: para añadir o modificar plantillas solo hay que cambiar workflow-templates; este servicio no requiere cambios.

• Revisión automatizada: run.py añade el parámetro --auto-review; cuando el MCP se ejecuta automáticamente, omite la interacción humana y la salida lleva la marca review_note; el llamante verifica los números clave.

• Aislamiento de ejecución: cada ejecución escribe un archivo de entrada temporal (se elimina tras su uso) y la salida se guarda en disco en output/ de la plantilla.

Inicio rápido

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

Requisitos previos: el repositorio workflow-templates está en esta máquina en E:\NEMB\workflow-templates (se puede sobrescribir con la variable de entorno WORKFLOW_TEMPLATES_HOME); el .env incluido en la plantilla (p. ej., la clave de OpenRouter) lo carga run.py automáticamente.

Prueba de extremo a extremo (ejecutará realmente una plantilla de análisis de informes financieros):

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

Integración con WorkBuddy

Fusiona examples/workbuddy_mcp.json en mcpServers de C:\Users\33033\.workbuddy\mcp.json; en la página de administración de conectores, haz clic en «Confiar» en workflow-mcp para habilitarlo. Después podrás decir directamente en el chat: "ayúdame a ejecutar la plantilla de análisis de informes financieros".

Relación con el trío de componentes

Hoja de ruta

• v0.1: tres herramientas list / get / run + --auto-review (actual)

• v0.2: persistir la salida de las plantillas en base de datos (resultados trazables), cola de ejecución concurrente, importación de plantillas versión n8n

• v0.3: combinar con digital-twin-mcp para formar la plantilla «informe de salud del dispositivo» (canalización de datos × canalización intelectual)

Licencia

MIT License