Task Manager MCP Server

Instructions

Implementation Reference

• src/tools.ts:318-416 (handler)

  The main execution logic for the 'get_task_stats' tool. Loads tasks from storage, computes comprehensive statistics (total, by status, priority, categories, overdue, due soon, completion rate), and returns a formatted markdown-like text response.

  export async function getTaskStats() {
    const storage = await loadTasks();
    const tasks = storage.tasks;
  
    if (tasks.length === 0) {
      return {
        content: [
          {
            type: "text",
            text: "No tasks yet. Create your first task to get started!",
          },
        ],
      };
    }
  
    // Calculate statistics
    const total = tasks.length;
    const byStatus = {
      pending: tasks.filter((t) => t.status === "pending").length,
      in_progress: tasks.filter((t) => t.status === "in_progress").length,
      completed: tasks.filter((t) => t.status === "completed").length,
    };
  
    const byPriority = {
      high: tasks.filter((t) => t.priority === "high").length,
      medium: tasks.filter((t) => t.priority === "medium").length,
      low: tasks.filter((t) => t.priority === "low").length,
    };
  
    // Category counts
    const categories = new Map<string, number>();
    tasks.forEach((t) => {
      if (t.category) {
        categories.set(t.category, (categories.get(t.category) || 0) + 1);
      }
    });
  
    // Check for overdue and upcoming tasks
    const today = new Date().toISOString().split("T")[0]!;
    const oneWeekFromNow = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000)
      .toISOString()
      .split("T")[0]!;
  
    const overdue = tasks.filter(
      (t) => t.status !== "completed" && t.dueDate && t.dueDate < today
    ).length;
  
    const dueSoon = tasks.filter(
      (t) =>
        t.status !== "completed" &&
        t.dueDate &&
        t.dueDate >= today &&
        t.dueDate <= oneWeekFromNow
    ).length;
  
    const completionRate =
      total > 0 ? ((byStatus.completed / total) * 100).toFixed(1) : "0";
  
    // Format output
    let result = "📊 Task Manager Statistics\n";
    result += "=".repeat(30) + "\n\n";
    result += `📈 Total Tasks: ${total}\n`;
    result += `✅ Completion Rate: ${completionRate}%\n\n`;
  
    result += "Status Breakdown:\n";
    result += `  📋 Pending: ${byStatus.pending}\n`;
    result += `  ⏳ In Progress: ${byStatus.in_progress}\n`;
    result += `  ✅ Completed: ${byStatus.completed}\n\n`;
  
    result += "Priority Breakdown:\n";
    result += `  🔴 High: ${byPriority.high}\n`;
    result += `  🟡 Medium: ${byPriority.medium}\n`;
    result += `  🟢 Low: ${byPriority.low}\n`;
  
    if (categories.size > 0) {
      result += "\nCategories:\n";
      Array.from(categories.entries())
        .sort((a, b) => a[0].localeCompare(b[0]))
        .forEach(([cat, count]) => {
          result += `  📁 ${cat}: ${count}\n`;
        });
    }
  
    if (overdue > 0) {
      result += `\n⚠️ Overdue Tasks: ${overdue}\n`;
    }
    if (dueSoon > 0) {
      result += `📅 Due Within 7 Days: ${dueSoon}\n`;
    }
  
    return {
      content: [
        {
          type: "text",
          text: result,
        },
      ],
    };
  }

• src/index.ts:171-178 (schema)

  JSON Schema definition for the tool in the TOOLS array, specifying name, description, and empty input schema (no parameters required).

  {
    name: "get_task_stats",
    description: "Get statistics about all tasks",
    inputSchema: {
      type: "object",
      properties: {},
    },
  },

• src/index.ts:233-234 (registration)

  Registration in the tool dispatch switch statement within the CallToolRequestSchema handler, mapping the tool name to the getTaskStats function call.

  case "get_task_stats":
    return await getTaskStats();

• src/index.ts:19-19 (registration)

  Import of the getTaskStats handler function from './tools.js'.

  getTaskStats,