algokit-mcp 1.0.0

package/dist/tools/fetch-problem-content-boj.js

@@ -0,0 +1,93 @@
+/**
+ * fetch_problem_content_boj MCP 도구
+ *
+ * Phase 6 - P6-004: BOJ 문제 본문 스크래핑 MCP 도구 구현
+ */
+import { z } from 'zod';
+import { BOJScraper, BojFetchError } from '../api/boj-scraper.js';
+import { parseProblemContent, HtmlParseError } from '../utils/html-parser.js';
+/**
+ * 입력 스키마
+ */
+export const FetchProblemContentBOJInputSchema = z.object({
+    problem_id: z.number().int().positive()
+        .describe('백준 문제 번호'),
+});
+/**
+ * fetch_problem_content_boj 도구 핸들러
+ *
+ * @param args - 입력 인자 (problem_id)
+ * @returns ProblemContent JSON 문자열
+ * @throws {Error} 검증 실패, 스크래핑 실패, 파싱 실패 시
+ */
+export async function handleFetchProblemContentBOJ(args) {
+    try {
+        // 1. 입력 검증
+        const { problem_id } = FetchProblemContentBOJInputSchema.parse(args);
+        // 2. BOJ 페이지 스크래핑
+        const scraper = new BOJScraper();
+        const html = await scraper.fetchProblemPage(problem_id);
+        // 3. HTML 파싱
+        const content = parseProblemContent(html, problem_id);
+        // 4. JSON 문자열로 반환
+        return {
+            type: 'text',
+            text: JSON.stringify(content, null, 2),
+        };
+    }
+    catch (error) {
+        // Zod 검증 에러
+        if (error instanceof z.ZodError) {
+            throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+        }
+        // BOJ 스크래핑 에러
+        if (error instanceof BojFetchError) {
+            if (error.code === 'NOT_FOUND') {
+                throw new Error(`문제를 찾을 수 없습니다: ${args.problem_id}번`);
+            }
+            if (error.code === 'TIMEOUT') {
+                throw new Error(`문제 페이지 요청이 타임아웃되었습니다: ${args.problem_id}번`);
+            }
+            if (error.code === 'NETWORK_ERROR') {
+                throw new Error(`네트워크 에러가 발생했습니다: ${error.message}`);
+            }
+            if (error.code === 'PARSE_ERROR') {
+                throw new Error(`문제 페이지 응답을 처리할 수 없습니다: ${error.message}`);
+            }
+        }
+        // HTML 파싱 에러
+        if (error instanceof HtmlParseError) {
+            throw new Error(`HTML 파싱 실패 (${error.field}): ${error.message}`);
+        }
+        // 기타 에러
+        throw error;
+    }
+}
+/**
+ * MCP 도구 정의
+ */
+export function fetchProblemContentBOJTool() {
+    return {
+        name: 'fetch_problem_content_boj',
+        description: `백준(BOJ) 문제 본문 스크래핑 (힌트 제외).
+
+BOJ 페이지에서 문제 제목, 설명, 입출력 형식, 예제, 제한사항을 가져옵니다.
+**힌트는 포함되지 않습니다** - generate_hint_boj 도구를 사용하세요.
+
+응답 구조: problemId, title, description, inputFormat, outputFormat, examples, limits, metadata
+
+**사용 시나리오**:
+- 문제 풀이 전 문제 본문 확인
+- 문제 복습 시 문제 내용 참조
+- 코드 분석 시 문제 요구사항 비교
+
+**제한사항**:
+- 스크래핑 대상: https://www.acmicpc.net/problem/{problem_id}
+- 타임아웃: 10초
+- 재시도: 최대 2회
+- 캐시: 30일`,
+        inputSchema: FetchProblemContentBOJInputSchema,
+        handler: handleFetchProblemContentBOJ,
+    };
+}
+//# sourceMappingURL=fetch-problem-content-boj.js.map

package/dist/tools/fetch-problem-content-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-problem-content-boj.js","sourceRoot":"","sources":["../../src/tools/fetch-problem-content-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,QAAQ,CAAC,UAAU,CAAC;CACxB,CAAC,CAAC;AAYH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,IAAa;IAC9D,IAAI,CAAC;QACH,WAAW;QACX,MAAM,EAAE,UAAU,EAAE,GAAG,iCAAiC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErE,kBAAkB;QAClB,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAExD,aAAa;QACb,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEtD,kBAAkB;QAClB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY;QACZ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,cAAc;QACd,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,kBAAmB,IAAoC,CAAC,UAAU,GAAG,CAAC,CAAC;YACzF,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,yBAA0B,IAAoC,CAAC,UAAU,GAAG,CAAC,CAAC;YAChG,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,aAAa;QACb,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,QAAQ;QACR,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;UAgBP;QACN,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,4BAA4B;KACtC,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-problem-content-programmers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * fetch_problem_content_programmers MCP 도구
+ *
+ * 프로그래머스 문제 본문을 ProblemContent 형태로 반환
+ */
+import { z } from 'zod';
+import type { ProgrammersScraper } from '../api/programmers-scraper.js';
+/**
+ * 입력 스키마
+ */
+export declare const FetchProblemContentProgrammersInputSchema: z.ZodObject<{
+    problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+}, "strip", z.ZodTypeAny, {
+    problem_id: string | number;
+}, {
+    problem_id: string | number;
+}>;
+export type FetchProblemContentProgrammersInput = z.infer<typeof FetchProblemContentProgrammersInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * fetch_problem_content_programmers 핸들러 (재사용 가능)
+ */
+export declare function handleFetchProblemContentProgrammers(args: unknown, scraper: ProgrammersScraper): Promise<TextContent>;
+/**
+ * fetch_problem_content_programmers 도구 핸들러
+ */
+export declare function fetchProblemContentProgrammersTool(scraper: ProgrammersScraper): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: string | number;
+    }, {
+        problem_id: string | number;
+    }>;
+    handler: (input: FetchProblemContentProgrammersInput) => Promise<TextContent>;
+};
+export {};
+//# sourceMappingURL=fetch-problem-content-programmers.d.ts.map

package/dist/tools/fetch-problem-content-programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-problem-content-programmers.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-problem-content-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAKxE;;GAEG;AACH,eAAO,MAAM,yCAAyC;;;;;;EAGpD,CAAC;AAEH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE5G;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,oCAAoC,CACxD,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAgCtB;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;;;qBAmBzD,mCAAmC;EAGvD"}

package/dist/tools/fetch-problem-content-programmers.js

@@ -0,0 +1,74 @@
+/**
+ * fetch_problem_content_programmers MCP 도구
+ *
+ * 프로그래머스 문제 본문을 ProblemContent 형태로 반환
+ */
+import { z } from 'zod';
+import { ProgrammersScrapeError } from '../api/programmers-scraper.js';
+import { parseProgrammersUrl } from '../utils/url-parser.js';
+import { programmersToProblemContent } from '../utils/programmers-converter.js';
+/**
+ * 입력 스키마
+ */
+export const FetchProblemContentProgrammersInputSchema = z.object({
+    problem_id: z.union([z.string(), z.number()])
+        .describe('프로그래머스 문제 ID 또는 URL'),
+});
+/**
+ * fetch_problem_content_programmers 핸들러 (재사용 가능)
+ */
+export async function handleFetchProblemContentProgrammers(args, scraper) {
+    try {
+        const { problem_id } = FetchProblemContentProgrammersInputSchema.parse(args);
+        const parsedId = parseProgrammersUrl(problem_id);
+        if (!parsedId) {
+            throw new Error(`유효하지 않은 프로그래머스 문제 ID 또는 URL: ${problem_id}`);
+        }
+        const detail = await scraper.getProblem(parsedId);
+        const content = programmersToProblemContent(detail);
+        return {
+            type: 'text',
+            text: JSON.stringify(content, null, 2),
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+        }
+        if (error instanceof ProgrammersScrapeError) {
+            if (error.code === 'NAVIGATION_ERROR') {
+                throw new Error(`문제를 찾을 수 없습니다: ${args.problem_id}`);
+            }
+            if (error.code === 'TIMEOUT') {
+                throw new Error(`요청이 타임아웃되었습니다: ${args.problem_id}`);
+            }
+        }
+        throw error;
+    }
+}
+/**
+ * fetch_problem_content_programmers 도구 핸들러
+ */
+export function fetchProblemContentProgrammersTool(scraper) {
+    return {
+        name: 'fetch_problem_content_programmers',
+        description: `프로그래머스 문제 본문 스크래핑.
+
+프로그래머스 페이지에서 문제 제목, 설명, 제한사항, 입출력 예시를 가져옵니다.
+
+응답 구조: problemId, title, description, inputFormat, outputFormat, examples, limits, metadata
+
+**사용 시나리오**:
+- 문제 풀이 전 문제 본문 확인
+- 코드 분석 시 문제 요구사항 비교
+
+**제한사항**:
+- 스크래핑 대상: https://school.programmers.co.kr/learn/courses/30/lessons/{problem_id}
+- 타임아웃: 10초
+- 재시도: 최대 2회
+- 캐시: 30일`,
+        inputSchema: FetchProblemContentProgrammersInputSchema,
+        handler: (input) => handleFetchProblemContentProgrammers(input, scraper),
+    };
+}
+//# sourceMappingURL=fetch-problem-content-programmers.js.map

package/dist/tools/fetch-problem-content-programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-problem-content-programmers.js","sourceRoot":"","sources":["../../src/tools/fetch-problem-content-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC,MAAM,CAAC;IAChE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC1C,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,IAAa,EACb,OAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,yCAAyC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;QAEpD,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,kBAAmB,IAA4C,CAAC,UAAU,EAAE,CAAC,CAAC;YAChG,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,kBAAmB,IAA4C,CAAC,UAAU,EAAE,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAA2B;IAC5E,OAAO;QACL,IAAI,EAAE,mCAAmC;QACzC,WAAW,EAAE;;;;;;;;;;;;;;UAcP;QACN,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,CAAC,KAA0C,EAAE,EAAE,CACtD,oCAAoC,CAAC,KAAK,EAAE,OAAO,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-problem-content.d.ts

@@ -0,0 +1,49 @@
+/**
+ * fetch_problem_content MCP 도구
+ *
+ * Phase 6 - P6-004: BOJ 문제 본문 스크래핑 MCP 도구 구현
+ */
+import { z } from 'zod';
+/**
+ * 입력 스키마
+ */
+export declare const FetchProblemContentInputSchema: z.ZodObject<{
+    problem_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    problem_id: number;
+}, {
+    problem_id: number;
+}>;
+export type FetchProblemContentInput = z.infer<typeof FetchProblemContentInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * fetch_problem_content 도구 핸들러
+ *
+ * @param args - 입력 인자 (problem_id)
+ * @returns ProblemContent JSON 문자열
+ * @throws {Error} 검증 실패, 스크래핑 실패, 파싱 실패 시
+ */
+export declare function handleFetchProblemContent(args: unknown): Promise<TextContent>;
+/**
+ * MCP 도구 정의
+ */
+export declare function fetchProblemContentTool(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: number;
+    }, {
+        problem_id: number;
+    }>;
+    handler: typeof handleFetchProblemContent;
+};
+export {};
+//# sourceMappingURL=fetch-problem-content.d.ts.map

package/dist/tools/fetch-problem-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-problem-content.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-problem-content.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;EAGzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CA+CnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB;;;;;;;;;;;EAuBtC"}

package/dist/tools/fetch-problem-content.js

@@ -0,0 +1,93 @@
+/**
+ * fetch_problem_content MCP 도구
+ *
+ * Phase 6 - P6-004: BOJ 문제 본문 스크래핑 MCP 도구 구현
+ */
+import { z } from 'zod';
+import { BOJScraper, BojFetchError } from '../api/boj-scraper.js';
+import { parseProblemContent, HtmlParseError } from '../utils/html-parser.js';
+/**
+ * 입력 스키마
+ */
+export const FetchProblemContentInputSchema = z.object({
+    problem_id: z.number().int().positive()
+        .describe('백준 문제 번호'),
+});
+/**
+ * fetch_problem_content 도구 핸들러
+ *
+ * @param args - 입력 인자 (problem_id)
+ * @returns ProblemContent JSON 문자열
+ * @throws {Error} 검증 실패, 스크래핑 실패, 파싱 실패 시
+ */
+export async function handleFetchProblemContent(args) {
+    try {
+        // 1. 입력 검증
+        const { problem_id } = FetchProblemContentInputSchema.parse(args);
+        // 2. BOJ 페이지 스크래핑
+        const scraper = new BOJScraper();
+        const html = await scraper.fetchProblemPage(problem_id);
+        // 3. HTML 파싱
+        const content = parseProblemContent(html, problem_id);
+        // 4. JSON 문자열로 반환
+        return {
+            type: 'text',
+            text: JSON.stringify(content, null, 2),
+        };
+    }
+    catch (error) {
+        // Zod 검증 에러
+        if (error instanceof z.ZodError) {
+            throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+        }
+        // BOJ 스크래핑 에러
+        if (error instanceof BojFetchError) {
+            if (error.code === 'NOT_FOUND') {
+                throw new Error(`문제를 찾을 수 없습니다: ${args.problem_id}번`);
+            }
+            if (error.code === 'TIMEOUT') {
+                throw new Error(`문제 페이지 요청이 타임아웃되었습니다: ${args.problem_id}번`);
+            }
+            if (error.code === 'NETWORK_ERROR') {
+                throw new Error(`네트워크 에러가 발생했습니다: ${error.message}`);
+            }
+            if (error.code === 'PARSE_ERROR') {
+                throw new Error(`문제 페이지 응답을 처리할 수 없습니다: ${error.message}`);
+            }
+        }
+        // HTML 파싱 에러
+        if (error instanceof HtmlParseError) {
+            throw new Error(`HTML 파싱 실패 (${error.field}): ${error.message}`);
+        }
+        // 기타 에러
+        throw error;
+    }
+}
+/**
+ * MCP 도구 정의
+ */
+export function fetchProblemContentTool() {
+    return {
+        name: 'fetch_problem_content',
+        description: `백준 문제 본문 스크래핑 (힌트 제외).
+
+BOJ 페이지에서 문제 제목, 설명, 입출력 형식, 예제, 제한사항을 가져옵니다.
+**힌트는 포함되지 않습니다** - generate_hint 도구를 사용하세요.
+
+응답 구조: problemId, title, description, inputFormat, outputFormat, examples, limits, metadata
+
+**사용 시나리오**:
+- 문제 풀이 전 문제 본문 확인
+- 문제 복습 시 문제 내용 참조
+- 코드 분석 시 문제 요구사항 비교
+
+**제한사항**:
+- 스크래핑 대상: https://www.acmicpc.net/problem/{problem_id}
+- 타임아웃: 10초
+- 재시도: 최대 2회
+- 캐시: 30일 (Phase 6-3에서 구현 예정)`,
+        inputSchema: FetchProblemContentInputSchema,
+        handler: handleFetchProblemContent,
+    };
+}
+//# sourceMappingURL=fetch-problem-content.js.map

package/dist/tools/fetch-problem-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-problem-content.js","sourceRoot":"","sources":["../../src/tools/fetch-problem-content.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,QAAQ,CAAC,UAAU,CAAC;CACxB,CAAC,CAAC;AAYH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAa;IAC3D,IAAI,CAAC;QACH,WAAW;QACX,MAAM,EAAE,UAAU,EAAE,GAAG,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElE,kBAAkB;QAClB,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAExD,aAAa;QACb,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEtD,kBAAkB;QAClB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY;QACZ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,cAAc;QACd,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,kBAAmB,IAAiC,CAAC,UAAU,GAAG,CAAC,CAAC;YACtF,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,yBAA0B,IAAiC,CAAC,UAAU,GAAG,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,aAAa;QACb,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,QAAQ;QACR,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;8BAgBa;QAC1B,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,yBAAyB;KACnC,CAAC;AACJ,CAAC"}

package/dist/tools/generate-hint-boj.d.ts

@@ -0,0 +1,42 @@
+/**
+ * generate_hint_boj MCP 도구
+ *
+ * BOJ 문제 힌트 가이드 생성 (SRP: 힌트만)
+ */
+import { z } from 'zod';
+import type { ProblemAnalyzer } from '../services/problem-analyzer.js';
+/**
+ * 입력 스키마
+ */
+export declare const GenerateHintBOJInputSchema: z.ZodObject<{
+    problem_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    problem_id: number;
+}, {
+    problem_id: number;
+}>;
+export type GenerateHintBOJInput = z.infer<typeof GenerateHintBOJInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * generate-hint 도구 핸들러
+ */
+export declare function generateHintBOJTool(analyzer: ProblemAnalyzer): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: number;
+    }, {
+        problem_id: number;
+    }>;
+    handler: (input: GenerateHintBOJInput) => Promise<TextContent>;
+};
+export {};
+//# sourceMappingURL=generate-hint-boj.d.ts.map

package/dist/tools/generate-hint-boj.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-boj.d.ts","sourceRoot":"","sources":["../../src/tools/generate-hint-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;EAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe;;;;;;;;;;qBAmClC,oBAAoB,KAAG,OAAO,CAAC,WAAW,CAAC;EA6BrE"}

package/dist/tools/generate-hint-boj.js

@@ -0,0 +1,80 @@
+/**
+ * generate_hint_boj MCP 도구
+ *
+ * BOJ 문제 힌트 가이드 생성 (SRP: 힌트만)
+ */
+import { z } from 'zod';
+import { ProblemNotFoundError } from '../api/types.js';
+/**
+ * 입력 스키마
+ */
+export const GenerateHintBOJInputSchema = z.object({
+    problem_id: z.number().int().positive()
+        .describe('백준 문제 번호'),
+});
+/**
+ * generate-hint 도구 핸들러
+ */
+export function generateHintBOJTool(analyzer) {
+    return {
+        name: 'generate_hint_boj',
+        description: `백준(BOJ) 문제 힌트 생성. 3단계 가이드 프롬프트 제공.
+
+🎯 **핵심: 한 번에 1개 레벨 힌트만 제공. 1,2,3 단계를 동시에 제시하지 마세요.**
+
+📋 응답에 포함된 정보:
+- hint_levels[0]: Level 1 - 문제 분석 (처음 시도)
+- hint_levels[1]: Level 2 - 핵심 아이디어 (부분 구현)
+- hint_levels[2]: Level 3 - 상세 풀이 (거의 완성)
+
+🤖 **사용자 상황 판단 → 적절한 1개 레벨만 제시**:
+
+1️⃣ Level 1 제시 (처음/막힐 때):
+   "사용자가 코드 없거나 어디서부터 시작해야 할지 모를 때"
+   → hint_levels[0].prompt로 문제 접근법 제시
+
+2️⃣ Level 2 제시 (다시 요청하거나 부분 구현 언급):
+   "사용자가 '더 필요해', '더 자세히' 요청하거나, 이미 코드를 시작했다고 언급"
+   → hint_levels[1].prompt로 핵심 로직 제시
+
+3️⃣ Level 3 제시 (상세 풀이 명시 요청):
+   "사용자가 '정답', '풀이', '코드' 등 최종 답변 요청"
+   → hint_levels[2].prompt로 상세 구현 가이드 제시
+
+📖 **[권장] 어려운 문제는 본문 먼저 확인**:
+   - 난이도 높은 문제(Gold 이상, level ≥ 11)는 메타데이터만으로 부족할 수 있음
+   - fetch_problem_content로 실제 문제 본문 확인 후 힌트 생성 권장
+   - 문제 본문을 보면 더 정확하고 맞춤형 힌트 제공 가능
+   - 예: mcp-cli call algokit/fetch_problem_content '{"problem_id": 1234}'
+   - 본문 확인은 권장사항이며 필수는 아님
+
+**정답 정책**: 힌트만 기본 제공. 사용자가 "정답", "풀이", "코드" 명시 요청 시만 전체 풀이 제공.`,
+        inputSchema: GenerateHintBOJInputSchema,
+        handler: async (input) => {
+            try {
+                // 입력 검증
+                const { problem_id } = GenerateHintBOJInputSchema.parse(input);
+                // 힌트 가이드 생성 (유사 문제 제외)
+                const result = await analyzer.analyze(problem_id, false);
+                // JSON 문자열로 반환 (Claude Code가 파싱)
+                return {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                };
+            }
+            catch (error) {
+                // Zod 검증 에러
+                if (error instanceof z.ZodError) {
+                    throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+                }
+                // ProblemNotFoundError
+                if (error instanceof ProblemNotFoundError) {
+                    throw new Error(`문제를 찾을 수 없습니다: ${input.problem_id}번`);
+                }
+                // 기타 에러
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-hint-boj.js.map

package/dist/tools/generate-hint-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-boj.js","sourceRoot":"","sources":["../../src/tools/generate-hint-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,QAAQ,CAAC,UAAU,CAAC;CACxB,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAyB;IAC3D,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DA8B8C;QAC3D,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,KAAK,EAAE,KAA2B,EAAwB,EAAE;YACnE,IAAI,CAAC;gBACH,QAAQ;gBACR,MAAM,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAE/D,uBAAuB;gBACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBAEzD,iCAAiC;gBACjC,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY;gBACZ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBAED,uBAAuB;gBACvB,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;oBAC1C,MAAM,IAAI,KAAK,CAAC,kBAAmB,KAA8B,CAAC,UAAU,GAAG,CAAC,CAAC;gBACnF,CAAC;gBAED,QAAQ;gBACR,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-hint-programmers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * generate_hint_programmers MCP 도구
+ *
+ * 프로그래머스 문제 힌트 가이드 생성 (SRP: 힌트만)
+ */
+import { z } from 'zod';
+import type { ProgrammersProblemAnalyzer } from '../services/programmers-problem-analyzer.js';
+/**
+ * 입력 스키마
+ */
+export declare const GenerateHintProgrammersInputSchema: z.ZodObject<{
+    problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+}, "strip", z.ZodTypeAny, {
+    problem_id: string | number;
+}, {
+    problem_id: string | number;
+}>;
+export type GenerateHintProgrammersInput = z.infer<typeof GenerateHintProgrammersInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * generate_hint_programmers 도구 핸들러
+ */
+export declare function generateHintProgrammersTool(analyzer: ProgrammersProblemAnalyzer): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: string | number;
+    }, {
+        problem_id: string | number;
+    }>;
+    handler: (input: GenerateHintProgrammersInput) => Promise<TextContent>;
+};
+export {};
+//# sourceMappingURL=generate-hint-programmers.d.ts.map

package/dist/tools/generate-hint-programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-programmers.d.ts","sourceRoot":"","sources":["../../src/tools/generate-hint-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAI9F;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;EAG7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,0BAA0B;;;;;;;;;;qBAgCrD,4BAA4B,KAAG,OAAO,CAAC,WAAW,CAAC;EA8B7E"}

package/dist/tools/generate-hint-programmers.js

@@ -0,0 +1,78 @@
+/**
+ * generate_hint_programmers MCP 도구
+ *
+ * 프로그래머스 문제 힌트 가이드 생성 (SRP: 힌트만)
+ */
+import { z } from 'zod';
+import { ProgrammersScrapeError } from '../api/programmers-scraper.js';
+import { parseProgrammersUrl } from '../utils/url-parser.js';
+/**
+ * 입력 스키마
+ */
+export const GenerateHintProgrammersInputSchema = z.object({
+    problem_id: z.union([z.string(), z.number()])
+        .describe('프로그래머스 문제 ID 또는 URL'),
+});
+/**
+ * generate_hint_programmers 도구 핸들러
+ */
+export function generateHintProgrammersTool(analyzer) {
+    return {
+        name: 'generate_hint_programmers',
+        description: `프로그래머스 문제 힌트 생성. 3단계 가이드 프롬프트 제공.
+
+🎯 **핵심: 한 번에 1개 레벨 힌트만 제공. 1,2,3 단계를 동시에 제시하지 마세요.**
+
+📋 응답에 포함된 정보:
+- hint_levels[0]: Level 1 - 문제 분석 (처음 시도)
+- hint_levels[1]: Level 2 - 핵심 아이디어 (부분 구현)
+- hint_levels[2]: Level 3 - 상세 풀이 (거의 완성)
+
+🤖 **사용자 상황 판단 → 적절한 1개 레벨만 제시**:
+
+1️⃣ Level 1 제시 (처음/막힐 때):
+   "사용자가 코드 없거나 어디서부터 시작해야 할지 모를 때"
+   → hint_levels[0].prompt로 문제 접근법 제시
+
+2️⃣ Level 2 제시 (다시 요청하거나 부분 구현 언급):
+   "사용자가 '더 필요해', '더 자세히' 요청하거나, 이미 코드를 시작했다고 언급"
+   → hint_levels[1].prompt로 핵심 로직 제시
+
+3️⃣ Level 3 제시 (상세 풀이 명시 요청):
+   "사용자가 '정답', '풀이', '코드' 등 최종 답변 요청"
+   → hint_levels[2].prompt로 상세 구현 가이드 제시
+
+📖 **[권장] 어려운 문제는 본문 먼저 확인**:
+   - 난이도 높은 문제(Lv. 3 이상)는 메타데이터만으로 부족할 수 있음
+   - fetch_problem_content_programmers로 실제 문제 본문 확인 후 힌트 생성 권장
+
+**정답 정책**: 힌트만 기본 제공. 사용자가 "정답", "풀이", "코드" 명시 요청 시만 전체 풀이 제공.`,
+        inputSchema: GenerateHintProgrammersInputSchema,
+        handler: async (input) => {
+            try {
+                const { problem_id } = GenerateHintProgrammersInputSchema.parse(input);
+                const parsedId = parseProgrammersUrl(problem_id);
+                if (!parsedId) {
+                    throw new Error(`유효하지 않은 프로그래머스 문제 ID 또는 URL: ${problem_id}`);
+                }
+                const result = await analyzer.analyze(parsedId, false);
+                return {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                };
+            }
+            catch (error) {
+                if (error instanceof z.ZodError) {
+                    throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+                }
+                if (error instanceof ProgrammersScrapeError) {
+                    if (error.code === 'NAVIGATION_ERROR') {
+                        throw new Error(`문제를 찾을 수 없습니다: ${input.problem_id}`);
+                    }
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-hint-programmers.js.map

package/dist/tools/generate-hint-programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-programmers.js","sourceRoot":"","sources":["../../src/tools/generate-hint-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC1C,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAoC;IAC9E,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;+DA2B8C;QAC3D,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,KAAK,EAAE,KAAmC,EAAwB,EAAE;YAC3E,IAAI,CAAC;gBACH,MAAM,EAAE,UAAU,EAAE,GAAG,kCAAkC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEvE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;gBACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAEvD,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBAED,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;oBAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACtC,MAAM,IAAI,KAAK,CAAC,kBAAmB,KAAsC,CAAC,UAAU,EAAE,CAAC,CAAC;oBAC1F,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}