# tarzan-workflow-mcp

**Repository Path**: qazll/tarzan-workflow-mcp

## Basic Information

- **Project Name**: tarzan-workflow-mcp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-04
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Workflow MCP Server

基于 MCP 协议的工作流管理工具。

## 自描述（instructions）

服务启动时加载根目录 [INSTRUCTIONS.md](./INSTRUCTIONS.md) 并通过 MCP `initialize` 响应的 `instructions` 字段下发给客户端。客户端（Agent）安装本服务后即可感知：什么任务应走工作流（任务路由）、标准调用流程和关键规则。修改该文件重启服务即可生效。`workflow_start` 的工具描述中也内置了流程提示，作为客户端不支持 `instructions` 字段时的兜底。

## 工具

| 工具 | 说明 |
|------|------|
| `workflow_doc` | 配置编写指南（唯一不需要 workspace 参数的工具） |
| `workflow_list_templates` | 列出模板 |
| `workflow_get_template` | 获取模板详情 |
| `workflow_start` | 启动实例 |
| `workflow_current` | 获取当前步骤和提示词 |
| `workflow_advance` | 推进到下一步 |
| `workflow_status` | 查看实例状态 |
| `workflow_list_instances` | 列出所有实例 |

## 使用

```
workflow_start({ workspace: "/project/path", templateId: "xxx", context: {...} })
workflow_current({ workspace: "/project/path", instanceId: "xxx" })
workflow_advance({ workspace: "/project/path", instanceId: "xxx" })
```

## 目录结构

```
{project}/
└── .workflow/
    ├── flows/
    │   └── your-flow/
    │       ├── flow.yaml
    │       └── prompts/
    ├── instances/
    └── checkpoints/
```

## flow.yaml

```yaml
name: my-flow
description: 描述

params:
  name:
    type: string
    required: true
    description: 参数

steps:
  - id: step1
    prompt: step1.md
```