MCP Workflow CLI

流程控制

代理工作流的编排+可观察性-具有MCP跟踪的多代理工作流系统。

概述

工作流控制是一个统一的系统，它：

1. 编排 多代理工作流（阶段、子代理、协调）
2. 轨迹 一切通过MCP工具+SQLite（决策、进度、文件）
3. 想象 实时工作流（WebUI仪表板）

建筑

Monorepo结构 （pnpm工作区）

workflow-control/
├── packages/
│   ├── shared/           # Prisma schema + Types (source of truth)
│   ├── mcp-server/       # MCP Server (tools for orchestration & tracking)
│   └── web-ui/           # Next.js Dashboard
├── workflow-system/      # Workflow orchestration docs & templates
│   ├── docs/             # Architecture, templates, profiles
│   └── agents/           # workflow-architect agent
├── scripts/              # Setup & installation scripts
└── .claude/              # Dev config for this project

安装

先决条件

• Node.js 20+ (下载)
• pnpm (npm install -g pnpm)
• 版本控制系统

自动设置

# Clone the repository
git clone 
cd workflow-control

# Run the setup script
./scripts/setup.sh

安装脚本将：

• 检查先决条件（Node.js 20+、pnpm、git）
• 安装依赖项
• 生成Prisma客户端
• 运行数据库迁移
• 构建项目
• 在中创建符号链接 ~/.claude/ 全球访问

手动设置

# Install dependencies
pnpm install

# Generate Prisma client
pnpm db:generate

# Run database migrations
pnpm db:migrate

# Build the project
pnpm build:all

配置

MCP服务器配置

将工作流控件添加到项目的 .mcp.json:

# Interactive mode
./scripts/generate-mcp-config.sh

# Or specify the project path
./scripts/generate-mcp-config.sh ~/my-project

# Or manually create .mcp.json:

{
  "mcpServers": {
    "workflow-control": {
      "command": "node",
      "args": ["/path/to/workflow-control/packages/mcp-server/dist/index.js"]
    }
  }
}

克劳德代码符号链接

安装脚本为全局访问创建符号链接：

~/.claude/docs/workflow-system/     -> Workflow System documentation
~/.claude/agents/workflow-architect.md -> Workflow Architect agent

要手动管理符号链接，请执行以下操作：

# Create symlinks
./scripts/symlink.sh

# Force overwrite existing
./scripts/symlink.sh --force

# Remove symlinks
./scripts/symlink.sh --remove

用法

启动Web UI

pnpm dev:ui

开放时间：http://localhost:3000

验证MCP服务器

./scripts/verify-mcp.sh

# With verbose output
./scripts/verify-mcp.sh --verbose

MCP工具可用

脚本参考

脚本选项

# Setup
./scripts/setup.sh --help
./scripts/setup.sh --silent          # Non-interactive mode
./scripts/setup.sh --skip-build      # Skip building
./scripts/setup.sh --skip-symlinks   # Skip symlink creation

# Symlinks
./scripts/symlink.sh --help
./scripts/symlink.sh --force         # Overwrite existing
./scripts/symlink.sh --remove        # Remove symlinks

# MCP Config
./scripts/generate-mcp-config.sh --help
./scripts/generate-mcp-config.sh --stdout   # Print to stdout
./scripts/generate-mcp-config.sh --force    # Overwrite existing

# Verify
./scripts/verify-mcp.sh --help
./scripts/verify-mcp.sh --verbose    # Detailed output
./scripts/verify-mcp.sh --timeout 30 # Custom timeout

技术栈

• MCP服务器：Node.js+TypeScript+@modelcontextprotocol/sdk
• 数据库：SQLite（本地，不需要外部服务器）
• 对象关系映射：Prisma（带TypeScript类型安全枚举）
• Web用户界面：Next.js 15+Socket.io（实时更新）
• Git集成：简单的git（快照/差异）

文档

技术文件在 .claude/docs/:

• architecture.md -系统架构
• mcp-tools.md -MCP工具规格
• 数据库.md -Prisma架构引用
• 标准.md -规范标准

工作流系统文档位于 workflow-system/docs/:

• architecture.md -工作流编排模式
• 模板/ -工作流和代理模板
• 配置文件/ -简单、标准和复杂的工作流配置文件

故障排除

未找到MCP服务器

# Rebuild the project
pnpm build:all

# Verify the binary exists
ls -la packages/mcp-server/dist/index.js

数据库错误

# Regenerate Prisma client
pnpm db:generate

# Reset and migrate database
pnpm db:migrate

Symlink问题

# Force recreate symlinks
./scripts/symlink.sh --force

# Check symlink targets
ls -la ~/.claude/docs/workflow-system
ls -la ~/.claude/agents/workflow-architect.md

验证一切正常

./scripts/verify-mcp.sh --verbose

卸载

# Remove symlinks
./scripts/symlink.sh --remove

# Remove database
rm packages/shared/prisma/dev.db

# Remove node_modules
rm -rf node_modules packages/*/node_modules

______________________________________________________________________

许可证：MIT