Task Orchestrator

🚀 タスクオーケストレータ

タスクのオーケストレーションと管理を行うためのモデルコンテキストプロトコル（MCP）サーバーです。このツールは、目標を管理可能なタスクに分解し、その進捗を追跡するのに役立ちます。

🚀 クイックスタート

理想的には、大規模言語モデル（LLM）がこのMCPツールをいつ使用すべきかを理解できるはずです。ただし、サンプルのプロンプトとして、次のようなものが機能する可能性があります。

「新しい開発目標を作成してください。目標は「ユーザー認証を実装する」で、「my-web-app」リポジトリに関するものです。」

遭遇した問題があれば、上部の「Discussions」タブで新しいissueを作成して知らせてください。

✨ 主な機能

• 目標の作成と管理
• 目標を階層的なタスクに分解
• タスクの完了状況の追跡
• サブタスクと親タスクとサブタスク間の依存関係管理のサポート
• LokiDBを使用した永続的なストレージ

📈 ロードマップ

• 複雑なタスク/目標の相互依存関係のオーケストレーション
• 目標の削除
• 完了処分
• 進捗状況を視覚化するためのUI

📚 ドキュメント

タスクIDの命名規則

タスクIDはドット表記（例：「1」、「1.1」、「1.1.1」）を使用し、各セグメントは階層のレベルを表します。

• 新しい目標ごとに、最上位レベルのタスクIDは「1」から始まり、順番に増加します（例：「1」、「2」、「3」）。
• サブタスクのIDは、親のIDに新しいセグメントを追加して形成されます（例：「1.1」は「1」のサブタスクです）。
• goalIdとtaskIdの組み合わせは一意であることが保証されます。

ツール

サーバーは以下のツールを提供します（build/index.jsに基づく）。

1. create_goal

   • 新しい目標を作成します。
   • パラメーター:

     {
       description: string;  // 目標の説明
       repoName: string;     // この目標に関連付けられたリポジトリ名
     }
     

   • サンプル入力:

     {
       "description": "Implement user authentication",
       "repoName": "example/auth-service"
     }
     

   • 戻り値: { goalId: number }

2. add_tasks

   • 目標に複数のタスクを追加します。タスクは階層構造で提供できます。既存のタスクの子タスクの場合は、parentIdフィールドを使用します。この操作はトランザクション的です。つまり、バッチ内のすべてのタスクが成功するか、または操作全体が失敗します。
   • パラメーター:

     {
       goalId: number; // タスクを追加する目標のID (number)
       tasks: Array<{
         title: string; // タスクのタイトル (string)
         description: string; // タスクの詳細な説明 (string)
         parentId?: string | null; // 既存のタスクの子タスクの場合のオプションの親タスクID。このバッチ内で階層的に定義される新しいサブタスクには使用しないでください。
         subtasks?: Array<any>; // このタスクの下に作成されるネストされたサブタスクオブジェクトの配列。
       }>;
     }
     

   • サンプル入力:

     {
       "goalId": 1,
       "tasks": [
         {
           "title": "Design database schema",
           "description": "Define tables for users, roles, and permissions",
           "subtasks": [
             {
               "title": "Create ERD",
               "description": "Draw entity-relationship diagram"
             }
           ]
         },
         {
           "title": "Implement user registration",
           "description": "Create API endpoint for new user signup",
           "parentId": "1"
         }
       ]
     }
     

   • 戻り値: HierarchicalTaskResponse[]。HierarchicalTaskResponseオブジェクトは簡略化されており、createdAt、updatedAt、またはparentIdを含みません。

3. remove_tasks

   • 目標から複数のタスクをソフト削除します。タスクは削除済みとしてマークされますが、システム内に残ります。デフォルトでは、サブタスクを持つ親タスクは、子タスクを明示的に削除しない限りソフト削除できません。ソフト削除されたタスクは、includeDeletedTasksがtrueに設定されていない限り、get_tasksの結果からデフォルトで除外されます。
   • パラメーター:

     {
       goalId: number; // タスクを削除する目標のID
       taskIds: string[]; // 削除するタスクのID (文字列の配列)。タスクIDはドット表記（例：「1」、「1.1」）を使用します。
       deleteChildren?: boolean; // 親と一緒に子タスクを削除するかどうか (boolean)。デフォルトはfalseです。falseの場合、既存のサブタスクを持つ親タスクを削除しようとするとエラーがスローされます。
     }
     

   • サンプル入力（子タスクを削除しない場合）:

     {
       "goalId": 1,
       "taskIds": ["2", "3"]
     }
     

   • サンプル入力（子タスクを削除する場合）:

     {
       "goalId": 1,
       "taskIds": ["1"],
       "deleteChildren": true
     }
     

   • 戻り値: { removedTasks: TaskResponse[], completedParents: TaskResponse[] }。TaskResponseオブジェクトは簡略化されており、createdAt、updatedAt、またはparentIdを含みません。

4. get_tasks

   • 目標のタスクを取得します。タスクIDはドット表記（例：「1」、「1.1」、「1.1.1」）を使用します。includeSubtasksが指定されている場合、レスポンスは階層的なタスクオブジェクトを返します。それ以外の場合は、createdAt、updatedAt、またはparentIdを含まない簡略化されたタスクオブジェクトが返されます。
   • パラメーター:

     {
       goalId: number; // タスクを取得する目標のID (number)
       taskIds?: string[]; // オプション: 取得するタスクのID (文字列の配列)。nullまたは空の場合、目標のすべてのタスクが取得されます。
       includeSubtasks?: "none" | "first-level" | "recursive"; // 含めるサブタスクのレベル: "none" (最上位レベルのタスクのみ)、"first-level" (最上位レベルのタスクとその直接の子タスク)、または "recursive" (すべてのネストされたサブタスク)。デフォルトは "none" です。
       includeDeletedTasks?: boolean; // 結果にソフト削除されたタスクを含めるかどうか (boolean)。デフォルトはfalseです。
     }
     

   • サンプル入力:

     {
       "goalId": 1,
       "includeSubtasks": "recursive",
       "includeDeletedTasks": true
     }
     

   • 戻り値: TaskResponse[]。TaskResponseオブジェクトは簡略化されており、createdAt、updatedAt、またはparentIdを含みません。

5. complete_task_status

   • タスクを完了としてマークします。デフォルトでは、未完了の子タスクを持つ親タスクは完了としてマークできません。
   • パラメーター:

     {
       goalId: number; // タスクが含まれる目標のID
       taskIds: string[]; // 更新するタスクのID (文字列の配列)。タスクIDはドット表記（例：「1」、「1.1」）を使用します。
       completeChildren?: boolean; // すべての子タスクを再帰的に完了するかどうか (boolean)。デフォルトはfalseです。falseの場合、タスクはすべてのサブタスクがすでに完了している場合にのみ完了できます。
     }
     

   • サンプル入力（子タスクを完了しない場合）:

     {
       "goalId": 1,
       "taskIds": ["1", "2"]
     }
     

   • サンプル入力（子タスクを完了する場合）:

     {
       "goalId": 1,
       "taskIds": ["1"],
       "completeChildren": true
     }
     

   • 戻り値: TaskResponse[]。TaskResponseオブジェクトは簡略化されており、createdAt、updatedAt、またはparentIdを含みません。

💻 使用例

目標とタスクの作成

// 新しい目標を作成します。その最上位レベルのタスクはID「1」から始まります。
const goal = await callTool('create_goal', {
  description: 'Implement user authentication',
  repoName: 'user/repo'
});

// 最上位レベルのタスクを追加します
const task1 = await callTool('add_tasks', {
  goalId: goal.goalId,
  tasks: [
    {
      title: 'Set up authentication middleware',
      description: 'Implement JWT-based authentication'
    }
  ]
});
// task1.addedTasks[0].id は「1」になります

// 前に作成したタスク「1」にサブタスクを追加します
const task2 = await callTool('add_tasks', {
  goalId: goal.goalId,
  tasks: [
    {
      title: 'Create login endpoint',
      description: 'Implement POST /auth/login',
      parentId: "1"  // ParentIdはすでに存在するタスクIDを参照する必要があります
    }
  ]
});
// task2.addedTasks[0].id は「1.1」になります

タスクの状態管理

// 親タスクを完了としてマークし、その子タスクも完了とします
await callTool('complete_task_status', {
  goalId: 1,
  taskIds: ["1"],
  completeChildren: true
});

// すべてのタスクを再帰的にサブタスクを含めて取得します
const allTasks = await callTool('get_tasks', {
  goalId: 1,
  includeSubtasks: "recursive"
});

タスクの削除

// 子タスクを削除せずに親タスクを削除しようとする（サブタスクがある場合はエラーになります）
try {
  await callTool('remove_tasks', {
    goalId: 1,
    taskIds: ["1"]
  });
} catch (error) {
  console.error(error.message); // サブタスクが存在する場合はエラーがスローされることが予想されます
}

// 親タスクとその子タスクを削除します
await callTool('remove_tasks', {
  goalId: 1,
  taskIds: ["1"],
  deleteChildren: true
});

🔧 開発

前提条件

• Node.js 18+
• pnpm

セットアップ

1. 依存関係をインストールします。

   pnpm install
   

2. プロジェクトをビルドします。

   pnpm build
   

3. テストを実行します。

   pnpm test
   

プロジェクト構造

• src/ - ソースコード
  • index.ts - メインサーバーの実装
  • storage.ts - データの永続化層
  • types.ts - TypeScriptの型定義
  • prompts.ts - AIプロンプトテンプレート
  • __tests__/ - テストファイル

📄 ライセンス

MIT