taskqueue-mcp
MCP 작업 관리자
MCP 작업 관리자( npm 패키지: taskqueue-mcp )는 AI 작업 관리를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 도구는 AI 비서가 여러 단계의 작업을 체계적으로 처리할 수 있도록 지원하며, 선택적으로 사용자 승인 체크포인트를 제공합니다.
특징
여러 단계로 구성된 작업 계획
진행 상황 추적
완료된 작업에 대한 사용자 승인
프로젝트 완료 승인
작업 세부 정보 시각화
작업 상태 관리
작업 검사 및 관리를 위한 향상된 CLI
Related MCP server: claude-sessions-mcp
기본 설정
일반적으로 Claude Desktop, Cursor 또는 다른 MCP 클라이언트에서 도구 구성을 다음과 같이 설정합니다.
지엑스피1
CLI 유틸리티를 사용하려면 다음 명령을 사용하면 됩니다.
npx taskqueue --help사용 가능한 명령과 옵션이 표시됩니다.
고급 구성
작업 관리자는 프로젝트 계획 생성을 위해 여러 LLM 공급자를 지원합니다. 사용하려는 공급자에 따라 다음 환경 변수 중 하나 이상을 구성할 수 있습니다.
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 파일에 데이터를 저장합니다.
기본 플랫폼별 위치는 다음과 같습니다.
리눅스 :
~/.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특허
MIT
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.-