@kmgeon/taskflow 0.1.3

package/src/mcp/tools/brainstorm.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { createTask } from "../../core/task/index.js";
+import { resolveProjectRoot } from "../util.js";
+
+export function registerBrainstormTools(server: McpServer): void {
+  server.tool(
+    "expand_subtasks",
+    "브레인스토밍 결과를 실제 태스크 파일로 생성합니다",
+    {
+      projectRoot: z.string().optional(),
+      parentTaskId: z.string(),
+      subtasks: z.array(z.object({
+        title: z.string(),
+        description: z.string(),
+        priority: z.number().optional(),
+        dependencies: z.array(z.string()).optional(),
+      })),
+    },
+    async ({ projectRoot, parentTaskId, subtasks }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const created = [];
+        for (const sub of subtasks) {
+          const task = await createTask(root, {
+            title: sub.title,
+            description: sub.description,
+            priority: sub.priority ?? 0,
+            parentId: parentTaskId,
+            dependencies: sub.dependencies,
+          });
+          created.push(task);
+        }
+        return {
+          content: [{
+            type: "text" as const,
+            text: `${created.length}개 서브태스크 생성 완료\n${JSON.stringify(created, null, 2)}`,
+          }],
+        };
+      } catch (error) {
+        return {
+          content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/src/mcp/tools/prd.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { savePrd } from "../../core/prd/generator.js";
+import { scanFiles, sampleFiles, inferProjectName } from "../../core/prd/scanner.js";
+import { resolveProjectRoot } from "../util.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+
+export function registerPrdTools(server: McpServer): void {
+  server.tool(
+    "scan_codebase",
+    "코드베이스를 스캔하여 파일 목록과 시그니처를 반환합니다 (AI 분석 없음)",
+    { projectRoot: z.string().optional() },
+    async ({ projectRoot }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const files = await scanFiles(root);
+        const samples = await sampleFiles(files, root);
+        const projectName = inferProjectName(samples, root);
+        return {
+          content: [{
+            type: "text" as const,
+            text: JSON.stringify({ files, samples, projectName }, null, 2),
+          }],
+        };
+      } catch (error) {
+        return {
+          content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }],
+          isError: true,
+        };
+      }
+    },
+  );
+
+  server.tool(
+    "save_prd",
+    "PRD 마크다운을 .taskflow/prd.md에 저장합니다",
+    { projectRoot: z.string().optional(), markdown: z.string() },
+    async ({ projectRoot, markdown }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const filePath = await savePrd(root, markdown);
+        return { content: [{ type: "text" as const, text: `PRD 저장 완료: ${filePath}` }] };
+      } catch (error) {
+        return {
+          content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }],
+          isError: true,
+        };
+      }
+    },
+  );
+
+  server.tool(
+    "read_prd",
+    ".taskflow/prd.md를 읽어서 반환합니다",
+    { projectRoot: z.string().optional() },
+    async ({ projectRoot }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const filePath = path.join(root, ".taskflow", "prd.md");
+        const content = await fs.readFile(filePath, "utf-8");
+        return { content: [{ type: "text" as const, text: content }] };
+      } catch (error) {
+        return {
+          content: [{ type: "text" as const, text: `오류: PRD 파일을 읽을 수 없습니다. ${error instanceof Error ? error.message : String(error)}` }],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/src/mcp/tools/project.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { initProject } from "../../core/project/init.js";
+import { generateClaudeMd, generateMcpJson, appendClaudeImport } from "../../core/project/claude-setup.js";
+import { resolveProjectRoot } from "../util.js";
+
+export function registerProjectTools(server: McpServer): void {
+  server.tool(
+    "initialize_project",
+    "프로젝트를 초기화합니다 (.taskflow 디렉토리 + config.json 생성)",
+    { projectRoot: z.string().optional(), projectName: z.string().optional() },
+    async ({ projectRoot, projectName }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const result = await initProject(root, projectName);
+        return { content: [{ type: "text" as const, text: result.created ? `프로젝트가 초기화되었습니다: ${root}/.taskflow` : `이미 초기화된 프로젝트입니다: ${root}/.taskflow` }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+
+  server.tool(
+    "generate_claude_md",
+    "CLAUDE.md를 동적으로 생성/갱신합니다",
+    { projectRoot: z.string().optional(), projectName: z.string(), summary: z.string().optional(), stack: z.array(z.string()).optional() },
+    async ({ projectRoot, projectName, summary, stack }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        await generateClaudeMd(root, { projectName, summary, stack });
+        await generateMcpJson(root);
+        await appendClaudeImport(root);
+        return { content: [{ type: "text" as const, text: "CLAUDE.md, .mcp.json 생성 완료" }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+}

package/src/mcp/tools/task-status.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { updateTask, listTasks, recommend } from "../../core/task/index.js";
+import { resolveProjectRoot } from "../util.js";
+
+export function registerTaskStatusTools(server: McpServer): void {
+  server.tool(
+    "set_task_status",
+    "태스크 상태를 변경합니다",
+    { projectRoot: z.string().optional(), taskId: z.string(), status: z.string() },
+    async ({ projectRoot, taskId, status }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const task = await updateTask(root, taskId, { status: status as any });
+        return { content: [{ type: "text" as const, text: `태스크 ${taskId} 상태 → ${task.status}` }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+
+  server.tool(
+    "get_next_task",
+    "의존성과 우선순위 기반으로 다음 작업할 태스크를 추천합니다",
+    { projectRoot: z.string().optional(), count: z.number().optional(), group: z.string().optional() },
+    async ({ projectRoot, count, group }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        let tasks = await listTasks(root);
+        if (group) {
+          tasks = tasks.filter((t) => t.group === group);
+        }
+        const recommendations = recommend(tasks, { limit: count ?? 3 });
+        return { content: [{ type: "text" as const, text: JSON.stringify(recommendations, null, 2) }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+}

package/src/mcp/tools/task.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { listTasks, readTask, createTask, updateTask, deleteTask } from "../../core/task/index.js";
+import { resolveProjectRoot } from "../util.js";
+
+export function registerTaskTools(server: McpServer): void {
+  server.tool(
+    "list_tasks",
+    "태스크 목록을 조회합니다",
+    { projectRoot: z.string().optional(), status: z.string().optional(), sortBy: z.string().optional(), sortOrder: z.string().optional() },
+    async ({ projectRoot, status, sortBy, sortOrder }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const tasks = await listTasks(root, { filter: status ? { status: status as any } : undefined, sortKey: sortBy as any, sortOrder: sortOrder as any });
+        return { content: [{ type: "text" as const, text: JSON.stringify(tasks, null, 2) }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+
+  server.tool(
+    "read_task",
+    "태스크 상세 정보를 조회합니다",
+    { projectRoot: z.string().optional(), taskId: z.string() },
+    async ({ projectRoot, taskId }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const task = await readTask(root, taskId);
+        if (!task) return { content: [{ type: "text" as const, text: `태스크를 찾을 수 없습니다: ${taskId}` }], isError: true };
+        return { content: [{ type: "text" as const, text: JSON.stringify(task, null, 2) }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+
+  server.tool(
+    "create_task",
+    "새 태스크를 생성합니다",
+    { projectRoot: z.string().optional(), title: z.string(), description: z.string().optional(), priority: z.number().optional(), status: z.string().optional(), parentId: z.string().optional(), dependencies: z.array(z.string()).optional(), group: z.string().optional() },
+    async ({ projectRoot, title, description, priority, status, parentId, dependencies, group }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const task = await createTask(root, { title, description, priority, status: status as any, parentId, dependencies, group });
+        return { content: [{ type: "text" as const, text: JSON.stringify(task, null, 2) }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+
+  server.tool(
+    "update_task",
+    "태스크를 수정합니다",
+    { projectRoot: z.string().optional(), taskId: z.string(), title: z.string().optional(), description: z.string().optional(), priority: z.number().optional(), status: z.string().optional(), dependencies: z.array(z.string()).optional() },
+    async ({ projectRoot, taskId, ...patch }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const task = await updateTask(root, taskId, patch as any);
+        return { content: [{ type: "text" as const, text: JSON.stringify(task, null, 2) }] };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+
+  server.tool(
+    "delete_task",
+    "태스크를 삭제합니다",
+    { projectRoot: z.string().optional(), taskId: z.string() },
+    async ({ projectRoot, taskId }) => {
+      try {
+        const root = resolveProjectRoot(projectRoot);
+        const removed = await deleteTask(root, taskId);
+        return { content: [{ type: "text" as const, text: removed ? `태스크 ${taskId} 삭제 완료` : `태스크를 찾을 수 없습니다: ${taskId}` }], isError: !removed };
+      } catch (error) {
+        return { content: [{ type: "text" as const, text: `오류: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+      }
+    },
+  );
+}

package/src/mcp/util.ts

@@ -0,0 +1,6 @@
+import path from "node:path";
+
+export function resolveProjectRoot(input?: string): string {
+  if (input) return path.resolve(input);
+  return process.cwd();
+}