workflow-mcp

workflow-templates リポジトリ内の AI ワークフローテンプレートを MCP 呼び出し可能ツール に変換します。あらゆる MCP クライアント（WorkBuddy、Claude Desktop、Cursor など）がテンプレートの一覧表示、契約の確認、テンプレートの実行、構造化された結果の取得を直接行えます。

デジタルパイプラインの建築家 · 第4の積み木：すべてのパイプラインを「プラグアンドプレイ」にする

できること

サンプルセッション：

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 が自動的に読み込みます。

エンドツーエンドテスト（実際に財務分析テンプレートを1回実行します）：

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 の3ツール + --auto-review（現在）

• v0.2：テンプレート出力のデータベース保存（結果の追跡可能）、並行実行キュー、n8n 版テンプレートのインポート

• v0.3：digital-twin-mcp と組み合わせて「デバイス健全性レポート」テンプレート（データパイプライン × 知的パイプライン）

ライセンス

MIT License