Progi

Name: Progi
Author: zseta

本地服务

github.com/zsetaAI 与智能体218 周前更新

代码仓库

关于 Progi

Progi 是面向 Agent 的 MCP 工作流引擎，可保存结构化工作流和逐步操作手册，让任务无需反复说明流程即可继续。它提供任务控制工具和监控界面，用于查看进度并调整操作手册。

主要功能

01根据自然语言创建工作流
02保存各步骤的操作手册
03创建并恢复工作流任务
04跟踪任务状态和输出记录
05在任务运行间调整操作手册

适用场景

01引导 Agent 执行重复代码审查
02在上下文重置后恢复任务
03监控多个工作流的进度
04在任务运行间改进流程

MCP 相关

Progi 以 MCP 服务形式运行，提供工作流编写、任务创建与恢复、进度更新和完成等工具。MCP 配置可选择同时启动用于监控的网页界面。

#workflow #workflow-engine #claude #automation #process #sop #memory

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": [
        "progi"
      ],
      "env": {
        "PROGI_DB_PATH": "<PROGI_DB_PATH>"
      }
    }
  }
}

启动命令uvx progi

需要配置的环境变量

PROGI_DB_PATHCustom path for the Progi SQLite database file

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiprogi0.3.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填
name	string	是
description	string	否
workflow_id	integer	是

详细介绍

Progi - MCP 原生工作流引擎

Progi 会教会你的 Agent 如何按照你的方式完成工作。这样，你就能发挥最佳水平，而不必反复解释自己的流程，也不会在不同会话之间丢失上下文。

开始使用

将 Progi 添加到你的 MCP 客户端配置中（GH Copilot / Cursor / Claude Code 等）：

{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": ["progi"]
    }
  }
}

Progi Monitoring 会自动在 http://127.0.0.1:8000 启动。

如果你想在其他端口启动 Monitoring：

{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": ["progi"],
      "env": {
        "PROGI_WEB_PORT": "8080"
      }
    }
  }
}

工作原理

1. 描述你的工作流

“嘿，Progi，帮我创建一个工作流，用于创建集成、审查代码和发布 PR。”

用通俗的语言描述你的流程。你可以详细说明，也可以只提供一个大致想法。Progi 会将其保存为结构化工作流，并为每个步骤配置操作手册。

2. 执行任务，随时掌握进展

“嘿，Progi，开始一个新任务，我们需要审查仓库中的一个新文档 PR。” 你的 Agent 会加载工作流，根据操作手册逐步执行，并在关键检查点让你参与审查输出。

3. 监控进度

Progi Monitoring 会实时展示每个正在运行和已完成的任务，包括状态、进度，以及所有工作流的完整输出历史。

4. 边做边优化

在两次运行之间，在 Progi Monitoring 中调整操作手册。由于工作流保存在数据库中，并且不会因上下文重置而丢失，因此未来的每项任务都会自动采用你的更改——每次迭代都会让你的流程更加完善。

MCP 工具

工作循环

工具	说明
`create_task`	在指定工作流下创建新任务（状态为 `todo`）；返回其第一步的预览
`list_tasks`	列出任务，可按状态和/或工作流筛选
`start_or_continue_task`	工作循环的主要入口——启动或恢复任务，并返回当前步骤的操作手册、输入数据和输出规范
`update_progress_notes`	覆盖任务的进度备注（步骤中途的保存点）
`finish_step`	将当前步骤标记为已完成，保存其输出，并推进到下一步（或标记为已完成）

工作流编写

工具	说明
`get_process_skeleton_prompt`	返回第 1 阶段系统提示词，用于将通俗语言描述转换为结构化工作流框架
`get_playbook_authoring_prompt`	返回第 2 阶段系统提示词，用于编写某一步骤的操作手册（会注入工作流上下文）
`save_workflow`	保存新的工作流及其步骤和操作手册
`list_workflows`	返回所有工作流及其按顺序排列的步骤

编写分为两个阶段：第 1 阶段将通俗语言描述转换为结构化框架；第 2 阶段编写每个步骤的操作手册。save_workflow 会保存两者。

配置

变量	默认值	用途
`PROGI_DB_PATH`	OS 数据目录（`platformdirs`）	SQLite 文件位置
`PROGI_WEB_HOST`	`127.0.0.1`	Web UI 绑定主机
`PROGI_WEB_PORT`	`8000`	Web UI 端口
`PROGI_NO_WEB`	`0`	设为 `1` 可禁用 Web UI