Skip to main content
Glama

MCP タスクマネージャー

鍛冶屋のバッジ

MCPタスクマネージャー( npmパッケージ:taskqueue-mcp )は、AIタスク管理のためのモデルコンテキストプロトコル(MCP)サーバーです。このツールは、AIアシスタントが複数ステップのタスクを構造的に処理するのを支援し、オプションでユーザー承認チェックポイントも設定できます。

特徴

  • 複数のステップによるタスク計画

  • 進捗状況の追跡

  • 完了したタスクのユーザー承認

  • プロジェクト完了承認

  • タスク詳細の視覚化

  • タスクステータス状態管理

  • タスクの検査と管理のための拡張CLI

Related MCP server: claude-sessions-mcp

基本設定

通常、Claude Desktop、Cursor、またはその他の MCP クライアントでツール構成を次のように設定します。

{
  "tools": {
    "taskqueue": {
      "command": "npx",
      "args": ["-y", "taskqueue-mcp"]
    }
  }
}

CLI ユーティリティを使用するには、次のコマンドを使用できます。

npx taskqueue --help

使用可能なコマンドとオプションが表示されます。

詳細設定

タスクマネージャーは、プロジェクト計画を生成するための複数のLLMプロバイダーをサポートしています。使用するプロバイダーに応じて、以下の環境変数を1つ以上設定できます。

  • OPENAI_API_KEY : OpenAIモデル(例:GPT-4)を使用するために必要

  • GOOGLE_GENERATIVE_AI_API_KEY : GoogleのGeminiモデルを使用するために必要

  • DEEPSEEK_API_KEY : Deepseekモデルを使用するために必要

CLI を使用してプロジェクト プランを生成するには、シェルで次の環境変数を設定します。

export OPENAI_API_KEY="your-api-key"
export GOOGLE_GENERATIVE_AI_API_KEY="your-api-key"
export DEEPSEEK_API_KEY="your-api-key"

または、MCP クライアント構成にそれらを含めて、MCP ツール呼び出しを使用してプロジェクト プランを生成することもできます。

{
  "tools": {
    "taskqueue": {
      "command": "npx",
      "args": ["-y", "taskqueue-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        "GOOGLE_GENERATIVE_AI_API_KEY": "your-api-key",
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

利用可能なMCPツール

TaskManager は、各操作に固有の専用ツールを備えた直接ツール インターフェイスを使用するようになりました。

プロジェクト管理ツール

  • list_projects : システム内のすべてのプロジェクトを一覧表示します

  • read_project : 特定のプロジェクトの詳細を取得します

  • create_project : 初期タスクを含む新しいプロジェクトを作成する

  • delete_project : プロジェクトを削除する

  • add_tasks_to_project : 既存のプロジェクトに新しいタスクを追加します

  • finalize_project : すべてのタスクが完了したらプロジェクトを確定します

タスク管理ツール

  • list_tasks : 特定のプロジェクトのすべてのタスクを一覧表示します

  • read_task : 特定のタスクの詳細を取得する

  • create_task : プロジェクトに新しいタスクを作成する

  • update_task : タスクのプロパティ(タイトル、説明、ステータス)を変更します

  • delete_task : プロジェクトからタスクを削除します

  • approve_task : 完了したタスクを承認する

  • get_next_task : プロジェクト内の次の保留中のタスクを取得します

  • mark_task_done : タスクを詳細とともに完了としてマークします

タスクのステータスとワークフロー

タスクには、次のいずれかのステータス フィールドがあります。

  • not started : タスクはまだ開始されていません

  • in progress : タスクは現在作業中です

  • done : タスクが完了しました( completedDetailsが必要です)

ステータス遷移ルール

システムは、タスク ステータスの遷移に対して次のルールを適用します。

  • タスクは、定義された有効な遷移を持つ特定のワークフローに従います。

    • not startedから: in progressにのみ移動できます

    • in progressから: doneに移動するか、 not startedに戻すことができます

    • doneから: 追加作業が必要な場合はin progressに戻すことができます

  • タスクが「完了」とマークされた場合、完了した内容を文書化するためにcompletedDetailsフィールドを提供する必要があります。

  • 承認されたタスクは変更できません

  • プロジェクトは、すべてのタスクが完了して承認された場合にのみ承認されます。

これらのルールは、タスクの進行状況の整合性を維持し、完了した作業の適切な文書化を保証するのに役立ちます。

使用ワークフロー

このタスク マネージャーを使用する LLM の一般的なワークフローは次のようになります。

  1. create_project : 初期タスクでプロジェクトを開始する

  2. get_next_task : 最初の保留中のタスクを取得する

  3. タスクに取り組む

  4. mark_task_done : タスクを詳細とともに完了としてマークする

  5. 承認を待つ(ユーザーはCLI経由でapprove_taskを呼び出す必要があります)

  6. get_next_task : 次の保留中のタスクを取得する

  7. すべてのタスクが完了するまで手順3~6を繰り返します

  8. finalize_project : プロジェクトを完了する(ユーザーの承認が必要)

CLIコマンド

タスク承認

タスクの承認は、CLI コマンドを通じてユーザーによってのみ制御されます。

npx taskqueue approve-task -- <projectId> <taskId>

オプション:

  • -f, --force : タスクが完了としてマークされていない場合でも承認を強制する

注意: タスクは、承認される前に完了した詳細とともに「完了」としてマークされる必要があります (--force を使用していない場合)。

タスクとプロジェクトの一覧表示

CLI には、すべてのプロジェクトとタスクを一覧表示するコマンドが用意されています。

npx taskqueue list-tasks

特定のプロジェクトの詳細を表示するには:

npx taskqueue list-tasks -- -p <projectId>

このコマンドは、システム内のすべてのプロジェクトまたは特定のプロジェクトに関する次のような情報を表示します。

  • プロジェクトIDと初期プロンプト

  • 完了ステータス

  • タスクの詳細(タイトル、説明、ステータス、承認)

  • 進捗指標(承認済み/完了済み/合計タスク)

データスキーマとストレージ

ファイルの場所

タスク マネージャーは、サーバーと CLI の両方からアクセスできる必要がある JSON ファイルにデータを保存します。

デフォルトのプラットフォーム固有の場所は次のとおりです。

  • Linux : ~/.local/share/taskqueue-mcp/tasks.json

  • macOS : ~/Library/Application Support/taskqueue-mcp/tasks.json

  • Windows : %APPDATA%\taskqueue-mcp\tasks.json

タスクデータの保存にカスタムファイルパスを使用することは推奨されません。MCPサーバーとCLIの両方に同じパスを設定する必要があるため、相互に連携できなくなります。カスタムパスを使用したい場合は、MCPクライアント設定でTASK_MANAGER_FILE_PATH環境変数を設定できます。

{
  "tools": {
    "taskqueue": {
      "command": "npx",
      "args": ["-y", "taskqueue-mcp"],
      "env": {
        "TASK_MANAGER_FILE_PATH": "/path/to/tasks.json"
      }
    }
  }
}

次に、CLI を実行する前に、シェルで同じパスをエクスポートする必要があります。

export TASK_MANAGER_FILE_PATH="/path/to/tasks.json"

データスキーマ

JSON ファイルは次の構造を使用します。

TaskManagerFile
├── projects: Project[]
    ├── projectId: string            # Format: "proj-{number}"
    ├── initialPrompt: string        # Original user request text
    ├── projectPlan: string          # Additional project details
    ├── completed: boolean           # Project completion status
    └── tasks: Task[]                # Array of tasks
        ├── id: string               # Format: "task-{number}"
        ├── title: string            # Short task title
        ├── description: string      # Detailed task description
        ├── status: string           # Task status: "not started", "in progress", or "done"
        ├── approved: boolean        # Task approval status
        ├── completedDetails: string # Completion information (required when status is "done")
        ├── toolRecommendations: string # Suggested tools that might be helpful for this task
        └── ruleRecommendations: string # Suggested rules/guidelines to follow for this task

ライセンス

マサチューセッツ工科大学

Available Tools

14 tools
add_tasks_to_projectC

Add new tasks to an existing project.

Inputs: projectId (required), tasks (required).

approve_taskA

Approve a completed task. Tasks must be marked as 'done' with completedDetails before approval. Note: This is a CLI-only operation that requires human intervention.

Inputs: projectId (required), taskId (required).

create_projectB

Create a new project with an initial prompt and a list of tasks. This is typically the first step in any workflow.

Inputs: initialPrompt (required), tasks (required), autoApprove, projectPlan.

create_taskC

Create a new task within an existing project. You can optionally include tool and rule recommendations to guide task completion.

Inputs: description (required), projectId (required), title (required), ruleRecommendations, +1 more.

delete_projectA

Delete a project and all its associated tasks.

Inputs: projectId (required).

delete_taskC

Remove a task from a project.

Inputs: projectId (required), taskId (required).

finalize_projectA

Mark a project as complete. Can only be called when all tasks are both done and approved. This is typically the last step in a project workflow.

Inputs: projectId (required).

generate_project_planC

Use an LLM to generate a project plan and tasks from a prompt. The LLM will analyze the prompt and any attached files to create a structured project plan.

Inputs: model (required), prompt (required), provider (required), attachments.

get_next_taskA

Get the next task to be done in a project. Returns the first non-approved task in sequence, regardless of status. The task may include toolRecommendations and ruleRecommendations fields that should be used to guide task completion.

Inputs: projectId (required).

list_projectsA

List all projects in the system and their basic information (ID, initial prompt, task counts), optionally filtered by state (open, pending_approval, completed, all).

Inputs: state.

list_tasksB

List all tasks, optionally filtered by project ID and/or state (open, pending_approval, completed, all). Tasks may include tool and rule recommendations to guide their completion.

Inputs: projectId, state.

read_projectB

Read all information for a given project, by its ID, including its tasks' statuses.

Inputs: projectId (required).

read_taskB

Get details of a specific task by its ID. The task may include toolRecommendations and ruleRecommendations fields that should be used to guide task completion.

Inputs: projectId (required), taskId (required).

update_taskA

Modify a task's properties. Note: (1) completedDetails are required when setting status to 'done', (2) approved tasks cannot be modified, (3) status must follow valid transitions: not started → in progress → done. You can also update tool and rule recommendations to guide task completion.

Inputs: projectId (required), taskId (required), completedDetails, description, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 14 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific resources and actions, with no ambiguity. For example, create_project vs. read_project vs. delete_project, and create_task vs. update_task vs. approve_task, each handles a unique operation in the task/project lifecycle.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case throughout, such as create_project, list_tasks, and update_task. There are no deviations in naming conventions, making the set predictable and readable.

    Tool Count5/5

    With 14 tools, the count is well-scoped for managing tasks and projects, covering operations from creation to finalization. Each tool earns its place by addressing distinct aspects of the domain without being excessive or insufficient.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for projects and tasks, including creation, reading, updating, deletion, listing, approval, and finalization. There are no obvious gaps, and tools like generate_project_plan and get_next_task enhance workflow support without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers