taskqueue-mcp
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 の一般的なワークフローは次のようになります。
create_project: 初期タスクでプロジェクトを開始するget_next_task: 最初の保留中のタスクを取得するタスクに取り組む
mark_task_done: タスクを詳細とともに完了としてマークする承認を待つ(ユーザーはCLI経由で
approve_taskを呼び出す必要があります)get_next_task: 次の保留中のタスクを取得するすべてのタスクが完了するまで手順3~6を繰り返します
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.jsonmacOS :
~/Library/Application Support/taskqueue-mcp/tasks.jsonWindows :
%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 toolsadd_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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for generating rough-draft project plans from natural-language prompts.
Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.
Related MCP Servers
- AlicenseAqualityDmaintenanceModel Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.10689 npm216MIT
- AlicenseBqualityDmaintenanceMCP server for managing Claude Code conversation sessions12MIT
- AlicenseNot gradedqualityDmaintenanceA flexible MCP server enabling multiple Claude AI sessions to coordinate work across machines through shared state management.1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that lets Claude Code dispatch tasks to the LiteLLM gateway, supporting both local Ollama models and Anthropic models via the gateway.-