Skip to main content
Glama
Sign In
enesjakozh
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

by kazuph
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript

MCP 작업 관리자

작업 관리를 위한 모델 컨텍스트 프로토콜 서버입니다. 이를 통해 Claude Desktop(또는 모든 MCP 클라이언트)은 큐 기반 시스템에서 작업을 관리하고 실행할 수 있습니다.

빠른 시작(사용자용)

필수 조건

구성

  1. ~/Library/Application Support/Claude/claude_desktop_config.json 에서 Claude Desktop 구성 파일을 엽니다.

Claude Desktop 메뉴를 통해 이 기능을 찾을 수 있습니다.

  1. 클로드 데스크톱 열기

  2. Mac 메뉴 막대에서 Claude를 클릭하세요

  3. "설정"을 클릭하세요

  4. "개발자"를 클릭하세요

  5. 구성에 다음을 추가하세요.

지엑스피1

Related MCP server: Todoist MCP Server

개발자를 위한

필수 조건

  • Node.js 18+ ( brew install node 통해 설치)

  • Claude Desktop( https://claude.ai/desktop 에서 설치)

  • tsx ( npm install -g tsx 를 통해 설치)

설치

git clone https://github.com/kazuph/mcp-taskmanager.git
cd mcp-taskmanager
npm install
npm run build

개발 구성

  1. Claude Desktop이 설치되어 실행 중인지 확인하세요.

  2. 아직 설치하지 않았다면 tsx를 전역적으로 설치하세요.

npm install -g tsx
# or
pnpm add -g tsx

  1. ~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 Claude Desktop 구성을 수정하세요.

MCP 클라이언트 구성에 다음을 추가하세요.

{
  "tools": {
    "taskmanager": {
      "args": ["tsx", "/path/to/mcp-taskmanager/index.ts"]
    }
  }
}

사용 가능한 작업

TaskManager는 두 가지 주요 작업 단계를 지원합니다.

계획 단계

  • 사용자로부터 작업 목록(문자열 배열)을 수락합니다.

  • 작업을 내부적으로 큐로 저장합니다.

  • 실행 계획(작업 개요, 작업 ID, 현재 대기열 상태)을 반환합니다.

실행 단계

  • 요청 시 대기열에서 다음 작업을 반환합니다.

  • 작업 완료에 대한 피드백 메커니즘을 제공합니다.

  • 대기열에서 완료된 작업을 제거합니다.

  • 다음 작업을 실행하기 위해 준비합니다.

매개변수

  • action : "계획" | "실행" | "완료"

  • tasks : 작업 문자열 배열("계획" 작업에 필요)

  • taskId : 작업 식별자("완료" 작업에 필요)

  • getNext : 다음 작업을 요청하기 위한 부울 플래그("실행" 작업용)

사용 예

// Planning phase
{
  action: "plan",
  tasks: ["Task 1", "Task 2", "Task 3"]
}

// Execution phase
{
  action: "execute",
  getNext: true
}

// Complete task
{
  action: "complete",
  taskId: "task-123"
}

Available Tools

10 tools
add_tasks_to_requestC

Add new tasks to an existing request. This allows extending a request with additional tasks.

A progress table will be displayed showing all tasks including the newly added ones.

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

approve_request_completionA

After all tasks are done and approved, this tool finalizes the entire request. The user must call this to confirm that the request is fully completed.

A progress table showing the final status of all tasks will be displayed before requesting final approval.

If not approved, the user can add new tasks using 'request_planning' and continue the process.

Inputs: requestId (required).

approve_task_completionA

Once the assistant has marked a task as done using 'mark_task_done', the user must call this tool to approve that the task is genuinely completed. Only after this approval can you proceed to 'get_next_task' to move on.

A progress table will be displayed before requesting approval, showing the current status of all tasks.

If the user does not approve, do not call 'get_next_task'. Instead, the user may request changes, or even re-plan tasks by using 'request_planning' again.

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

delete_taskB

Delete a specific task from a request. Only uncompleted tasks can be deleted.

A progress table will be displayed showing the remaining tasks after deletion.

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

get_next_taskA

Given a 'requestId', return the next pending task (not done yet). If all tasks are completed, it will indicate that no more tasks are left and that you must wait for the request completion approval.

A progress table showing the current status of all tasks will be displayed with each response.

If the same task is returned again or if no new task is provided after a task was marked as done but not yet approved, you MUST NOT proceed. In such a scenario, you must prompt the user for approval via 'approve_task_completion' before calling 'get_next_task' again. Do not skip the user's approval step. In other words:

  • After calling 'mark_task_done', do not call 'get_next_task' again until 'approve_task_completion' is called by the user.

  • If 'get_next_task' returns 'all_tasks_done', it means all tasks have been completed. At this point, you must not start a new request or do anything else until the user decides to 'approve_request_completion' or possibly add more tasks via 'request_planning'.

Inputs: requestId (required).

list_requestsB

List all requests with their basic information and summary of tasks. This provides a quick overview of all requests in the system.

Inputs: no named parameters.

mark_task_doneA

Mark a given task as done after you've completed it. Provide 'requestId' and 'taskId', and optionally 'completedDetails'.

After marking a task as done, a progress table will be displayed showing the updated status of all tasks.

After this, DO NOT proceed to 'get_next_task' again until the user has explicitly approved this completed task using 'approve_task_completion'.

Inputs: requestId (required), taskId (required), completedDetails.

open_task_detailsB

Get details of a specific task by 'taskId'. This is for inspecting task information at any point.

Inputs: taskId (required).

request_planningA

Register a new user request and plan its associated tasks. You must provide 'originalRequest' and 'tasks', and optionally 'splitDetails'.

This tool initiates a new workflow for handling a user's request. The workflow is as follows:

  1. Use 'request_planning' to register a request and its tasks.

  2. After adding tasks, you MUST use 'get_next_task' to retrieve the first task. A progress table will be displayed.

  3. Use 'get_next_task' to retrieve the next uncompleted task.

  4. IMPORTANT: After marking a task as done, the assistant MUST NOT proceed to another task without the user's approval. The user must explicitly approve the completed task using 'approve_task_completion'. A progress table will be displayed before each approval request.

  5. Once a task is approved, you can proceed to 'get_next_task' again to fetch the next pending task.

  6. Repeat this cycle until all tasks are done.

  7. After all tasks are completed (and approved), 'get_next_task' will indicate that all tasks are done and that the request awaits approval for full completion.

  8. The user must then approve the entire request's completion using 'approve_request_completion'. If the user does not approve and wants more tasks, you can again use 'request_planning' to add new tasks and continue the cycle.

The critical point is to always wait for user approval after completing each task and after all tasks are done, wait for request completion approval. Do not proceed automatically.

Inputs: originalRequest (required), tasks (required), splitDetails.

update_taskB

Update an existing task's title and/or description. Only uncompleted tasks can be updated.

A progress table will be displayed showing the updated task information.

Inputs: requestId (required), taskId (required), description, title.

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a distinct purpose with clear boundaries. For example, 'approve_task_completion' is for approving individual tasks, while 'approve_request_completion' is for finalizing the entire request, and 'mark_task_done' is for marking tasks as done, distinct from approval. There is no overlap that would cause confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with underscores, such as 'add_tasks_to_request', 'approve_request_completion', and 'get_next_task'. The naming is uniform and predictable throughout the set, making it easy to understand each tool's function.

    Tool Count5/5

    With 10 tools, the server is well-scoped for task management. It covers the full lifecycle of requests and tasks, from creation to completion, without being overly complex or too sparse. Each tool serves a specific role in the workflow, justifying its inclusion.

    Completeness5/5

    The tool set provides complete coverage for task management workflows. It includes planning ('request_planning'), task operations (add, update, delete, mark as done, get details, get next), approvals (task and request levels), and listing requests. There are no obvious gaps; agents can handle the entire process from start to finish.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches