Progi

Progi - MCP ネイティブのワークフローエンジン

Progi は、あなた好みの仕事の進め方をエージェントに教えます。そのため、作業の進め方を何度も説明し直したり、セッション間でコンテキストを失ったりせずに、最高の仕事ができます。

---

はじめに

MCP クライアントの設定に Progi を追加します（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 をレビューする必要があるんだ。」 エージェントはワークフローを読み込み、プレイブックに従って各ステップを進め、重要なチェックポイントでは出力をレビューできるよう、あなたに確認を求めます。

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	平易な言葉で書かれた説明を構造化されたワークフローの骨組みに変換するための、Pass 1 のシステムプロンプトを返します
get_playbook_authoring_prompt	ステップのプレイブックを作成するための、Pass 2 のシステムプロンプトを返します（ワークフローのコンテキストを挿入します）
save_workflow	新しいワークフローとそのステップおよびプレイブックを保存します
list_workflows	すべてのワークフローと、順序付けられたステップを返します

作成は 2 つのパスで行います。Pass 1 では平易な言葉で書かれた説明を構造化された骨組みに変換し、Pass 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	Web UI を無効にするには 1 を設定します

実行モード：uvx progi（MCP + Web UI）、uvx progi --no-web（MCP のみ）、uvx progi-web（Web UI のみ）。

PROGI_DB_PATH には絶対パスを使用してください