algokit-mcp 1.0.2 → 1.0.4

package/dist/tools/programmers/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/programmers/generate-hint-programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-programmers.d.ts","sourceRoot":"","sources":["../../../src/tools/programmers/generate-hint-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAIjG;;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;;;;;;;;;;qBAkCrD,4BAA4B,KAAG,OAAO,CAAC,WAAW,CAAC;EA8B7E"}

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

@@ -0,0 +1,80 @@
+/**
+ * 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로 실제 문제 본문 확인 후 힌트 생성 권장
+
+**정답 정책**: 힌트만 기본 제공. 사용자가 "정답", "풀이", "코드" 명시 요청 시만 전체 풀이 제공.
+
+⚠️ 플랫폼 판별: 문제 번호만 입력된 경우 대화 맥락에서 플랫폼을 파악하거나, 맥락이 없으면 반드시 BOJ/프로그래머스 중 어느 플랫폼인지 사용자에게 확인 후 호출하세요.`,
+        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/programmers/generate-hint-programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-programmers.js","sourceRoot":"","sources":["../../../src/tools/programmers/generate-hint-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGA6BgF;QAC7F,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"}

package/dist/tools/programmers/generate-review-template-programmers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * generate_review_template_programmers MCP 도구
+ *
+ * 프로그래머스 복습 템플릿 및 가이드 제공
+ */
+import { z } from 'zod';
+import type { ProgrammersReviewTemplateGenerator } from '../../services/programmers-review-template-generator.js';
+/**
+ * 입력 스키마
+ */
+export declare const GenerateReviewTemplateProgrammersInputSchema: z.ZodObject<{
+    problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    user_notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    problem_id: string | number;
+    user_notes?: string | undefined;
+}, {
+    problem_id: string | number;
+    user_notes?: string | undefined;
+}>;
+export type GenerateReviewTemplateProgrammersInput = z.infer<typeof GenerateReviewTemplateProgrammersInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * generate_review_template_programmers 도구 핸들러
+ */
+export declare function generateReviewTemplateProgrammersTool(generator: ProgrammersReviewTemplateGenerator): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        user_notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: string | number;
+        user_notes?: string | undefined;
+    }, {
+        problem_id: string | number;
+        user_notes?: string | undefined;
+    }>;
+    handler: (input: GenerateReviewTemplateProgrammersInput) => Promise<TextContent>;
+};
+export {};
+//# sourceMappingURL=generate-review-template-programmers.d.ts.map

package/dist/tools/programmers/generate-review-template-programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-review-template-programmers.d.ts","sourceRoot":"","sources":["../../../src/tools/programmers/generate-review-template-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yDAAyD,CAAC;AAIlH;;GAEG;AACH,eAAO,MAAM,4CAA4C;;;;;;;;;EAKvD,CAAC;AAEH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAElH;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,kCAAkC;;;;;;;;;;;;;qBAKxE,sCAAsC,KAAG,OAAO,CAAC,WAAW,CAAC;EA8BvF"}

package/dist/tools/programmers/generate-review-template-programmers.js

@@ -0,0 +1,53 @@
+/**
+ * generate_review_template_programmers MCP 도구
+ *
+ * 프로그래머스 복습 템플릿 및 가이드 제공
+ */
+import { z } from 'zod';
+import { ProgrammersScrapeError } from '../../api/programmers-scraper.js';
+import { parseProgrammersUrl } from '../../utils/url-parser.js';
+/**
+ * 입력 스키마
+ */
+export const GenerateReviewTemplateProgrammersInputSchema = z.object({
+    problem_id: z.union([z.string(), z.number()])
+        .describe('프로그래머스 문제 ID 또는 URL'),
+    user_notes: z.string().optional()
+        .describe('사용자가 미리 작성한 메모 (선택)'),
+});
+/**
+ * generate_review_template_programmers 도구 핸들러
+ */
+export function generateReviewTemplateProgrammersTool(generator) {
+    return {
+        name: 'generate_review_template_programmers',
+        description: '프로그래머스 문제에 대한 복기용 가이드를 제공합니다. 마크다운 템플릿, 문제 분석, 작성 프롬프트를 포함합니다.\n\n⚠️ 플랫폼 판별: 문제 번호만 입력된 경우 대화 맥락에서 플랫폼을 파악하거나, 맥락이 없으면 반드시 BOJ/프로그래머스 중 어느 플랫폼인지 사용자에게 확인 후 호출하세요.',
+        inputSchema: GenerateReviewTemplateProgrammersInputSchema,
+        handler: async (input) => {
+            try {
+                const { problem_id, user_notes } = GenerateReviewTemplateProgrammersInputSchema.parse(input);
+                const parsedId = parseProgrammersUrl(problem_id);
+                if (!parsedId) {
+                    throw new Error(`유효하지 않은 프로그래머스 문제 ID 또는 URL: ${problem_id}`);
+                }
+                const template = await generator.generate(parsedId, user_notes);
+                return {
+                    type: 'text',
+                    text: JSON.stringify(template, 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-review-template-programmers.js.map

package/dist/tools/programmers/generate-review-template-programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-review-template-programmers.js","sourceRoot":"","sources":["../../../src/tools/programmers/generate-review-template-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,CAAC,MAAM,CAAC;IACnE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC1C,QAAQ,CAAC,qBAAqB,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,UAAU,qCAAqC,CAAC,SAA6C;IACjG,OAAO;QACL,IAAI,EAAE,sCAAsC;QAC5C,WAAW,EAAE,oKAAoK;QACjL,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,KAAK,EAAE,KAA6C,EAAwB,EAAE;YACrF,IAAI,CAAC;gBACH,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,4CAA4C,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAE7F,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,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAEhE,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC,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,KAAgD,CAAC,UAAU,EAAE,CAAC,CAAC;oBACpG,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/programmers/get-problem-programmers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * get_problem_programmers MCP 도구
+ *
+ * Phase 7 - Task 7.5: 프로그래머스 문제 상세 조회 MCP 도구 구현
+ */
+import { z } from 'zod';
+/**
+ * 입력 스키마 (URL 또는 숫자 모두 지원)
+ */
+export declare const GetProgrammersProblemInputSchema: z.ZodObject<{
+    problem_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+}, "strip", z.ZodTypeAny, {
+    problem_id: string | number;
+}, {
+    problem_id: string | number;
+}>;
+export type GetProgrammersProblemInput = z.infer<typeof GetProgrammersProblemInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * get_problem_programmers 도구 핸들러
+ *
+ * @param args - 입력 인자 (problem_id)
+ * @returns ProgrammersProblemDetail 마크다운 문자열
+ * @throws {Error} 검증 실패, 스크래핑 실패, 파싱 실패 시
+ */
+export declare function handleGetProgrammersProblem(args: unknown): Promise<TextContent>;
+/**
+ * 테스트용 별칭 (backward compatibility)
+ */
+export declare const getProgrammersProblem: typeof handleGetProgrammersProblem;
+/**
+ * MCP 도구 정의
+ */
+export declare function getProgrammersProblemTool(): {
+    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: typeof handleGetProgrammersProblem;
+};
+export {};
+//# sourceMappingURL=get-problem-programmers.d.ts.map

package/dist/tools/programmers/get-problem-programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-problem-programmers.d.ts","sourceRoot":"","sources":["../../../src/tools/programmers/get-problem-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;EAG3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAsDrF;AAoED;;GAEG;AACH,eAAO,MAAM,qBAAqB,oCAA8B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;EA4BxC"}

package/dist/tools/programmers/get-problem-programmers.js

@@ -0,0 +1,163 @@
+/**
+ * get_problem_programmers MCP 도구
+ *
+ * Phase 7 - Task 7.5: 프로그래머스 문제 상세 조회 MCP 도구 구현
+ */
+import { z } from 'zod';
+import { ProgrammersScraper, ProgrammersScrapeError } from '../../api/programmers-scraper.js';
+import { parseProgrammersUrl } from '../../utils/url-parser.js';
+/**
+ * 입력 스키마 (URL 또는 숫자 모두 지원)
+ */
+export const GetProgrammersProblemInputSchema = z.object({
+    problem_id: z.union([z.string(), z.number()])
+        .describe('문제 ID 또는 프로그래머스 URL. 예: 42748 또는 https://school.programmers.co.kr/learn/courses/30/lessons/42748'),
+});
+/**
+ * get_problem_programmers 도구 핸들러
+ *
+ * @param args - 입력 인자 (problem_id)
+ * @returns ProgrammersProblemDetail 마크다운 문자열
+ * @throws {Error} 검증 실패, 스크래핑 실패, 파싱 실패 시
+ */
+export async function handleGetProgrammersProblem(args) {
+    try {
+        // 1. 입력 검증
+        const { problem_id } = GetProgrammersProblemInputSchema.parse(args);
+        // 2. URL 파싱 (URL 또는 숫자 모두 지원)
+        const problemId = parseProgrammersUrl(problem_id);
+        if (!problemId) {
+            throw new Error(`유효하지 않은 문제 ID 또는 URL: ${problem_id}`);
+        }
+        // 3. 프로그래머스 스크래핑
+        const scraper = new ProgrammersScraper();
+        const detail = await scraper.getProblem(problemId);
+        // 4. 마크다운 포맷팅
+        const markdown = formatProblemAsMarkdown(detail);
+        return {
+            type: 'text',
+            text: markdown,
+        };
+    }
+    catch (error) {
+        // Zod 검증 에러
+        if (error instanceof z.ZodError) {
+            throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+        }
+        // 프로그래머스 스크래핑 에러
+        if (error instanceof ProgrammersScrapeError) {
+            const problemId = args.problem_id;
+            if (error.code === 'NAVIGATION_ERROR') {
+                throw new Error(`문제를 찾을 수 없습니다: ${problemId}번`);
+            }
+            if (error.code === 'TIMEOUT') {
+                throw new Error(`문제 페이지 요청이 타임아웃되었습니다: ${problemId}번`);
+            }
+            if (error.code === 'PARSE_ERROR') {
+                throw new Error(`문제 페이지 응답을 처리할 수 없습니다: ${error.message}`);
+            }
+            if (error.code === 'SELECTOR_NOT_FOUND') {
+                throw new Error(`HTML 파싱 실패 (필수 요소 없음): ${error.message}`);
+            }
+        }
+        // 기타 에러
+        if (error instanceof Error) {
+            throw new Error(`프로그래머스 문제 조회 실패: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * 문제를 마크다운으로 포맷팅
+ */
+function formatProblemAsMarkdown(problem) {
+    const lines = [];
+    // 헤더
+    lines.push(`# ${problem.title}\n`);
+    lines.push(`**레벨**: ${formatLevel(problem.level)} | **카테고리**: ${problem.category}\n`);
+    lines.push(`**문제 ID**: ${problem.problemId}\n`);
+    lines.push(`**URL**: https://school.programmers.co.kr/learn/courses/30/lessons/${problem.problemId}\n`);
+    lines.push('---\n');
+    // 문제 설명
+    lines.push('## 문제 설명\n');
+    lines.push(problem.description);
+    lines.push('\n');
+    // 제한사항
+    if (problem.constraints.length > 0) {
+        lines.push('## 제한사항\n');
+        problem.constraints.forEach((c) => {
+            lines.push(`- ${c}`);
+        });
+        lines.push('\n');
+    }
+    // 입출력 예제
+    if (problem.examples.length > 0) {
+        lines.push('## 입출력 예\n');
+        lines.push('| 입력 | 출력 |');
+        lines.push('|------|------|');
+        problem.examples.forEach((ex) => {
+            lines.push(`| ${ex.input} | ${ex.output} |`);
+        });
+        lines.push('\n');
+    }
+    // 안내
+    lines.push('---');
+    lines.push('');
+    lines.push('💡 **다음 단계**:');
+    lines.push('- 문제 분석: `analyze_programmers_problem` (구현 예정)');
+    lines.push('- 코드 제출 분석: `analyze_code_submission` (BOJ만 지원)');
+    lines.push('');
+    lines.push('⚠️ **참고**: 프로그래머스 사이트에서 직접 문제를 풀어야 합니다.');
+    return lines.join('\n');
+}
+/**
+ * 레벨 포맷팅
+ */
+function formatLevel(level) {
+    const levelEmoji = {
+        0: '🟢 Lv. 0 (입문)',
+        1: '🟢 Lv. 1',
+        2: '🟡 Lv. 2',
+        3: '🟠 Lv. 3',
+        4: '🔴 Lv. 4',
+        5: '🔴 Lv. 5',
+    };
+    return levelEmoji[level] || `Lv. ${level}`;
+}
+/**
+ * 테스트용 별칭 (backward compatibility)
+ */
+export const getProgrammersProblem = handleGetProgrammersProblem;
+/**
+ * MCP 도구 정의
+ */
+export function getProgrammersProblemTool() {
+    return {
+        name: 'get_problem_programmers',
+        description: `프로그래머스 문제 상세 정보 조회 (웹 스크래핑).
+
+프로그래머스 페이지에서 문제 제목, 설명, 제한사항, 입출력 예제를 가져옵니다.
+
+응답 구조: problemId, title, level, category, description, constraints, examples, tags
+
+**사용 시나리오**:
+- 프로그래머스 문제 풀이 전 문제 본문 확인
+- 문제 복습 시 문제 내용 참조
+- 코드 분석 시 문제 요구사항 비교
+
+**제한사항**:
+- 스크래핑 대상: https://school.programmers.co.kr/learn/courses/30/lessons/{problem_id}
+- 타임아웃: 10초
+- 재시도: 최대 2회
+- Rate Limiting: 초당 1회
+
+**참고**:
+- BOJ와 다르게 프로그래머스는 fetch + cheerio 사용 (SSR 페이지)
+- 프로그래머스는 태그 정보가 없으므로 tags 필드는 빈 배열
+
+⚠️ 플랫폼 판별: 문제 번호만 입력된 경우 대화 맥락에서 플랫폼을 파악하거나, 맥락이 없으면 반드시 BOJ/프로그래머스 중 어느 플랫폼인지 사용자에게 확인 후 호출하세요.`,
+        inputSchema: GetProgrammersProblemInputSchema,
+        handler: handleGetProgrammersProblem,
+    };
+}
+//# sourceMappingURL=get-problem-programmers.js.map

package/dist/tools/programmers/get-problem-programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-problem-programmers.js","sourceRoot":"","sources":["../../../src/tools/programmers/get-problem-programmers.ts"],"names":[],"mappings":"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"}

package/dist/tools/programmers/search-problems-programmers.d.ts

@@ -0,0 +1,73 @@
+/**
+ * search_problems_programmers MCP 도구
+ *
+ * Phase 7 - Task 7.5: 프로그래머스 문제 검색 MCP 도구
+ */
+import { z } from 'zod';
+/**
+ * 입력 스키마
+ */
+export declare const SearchProgrammersProblemsInputSchema: z.ZodObject<{
+    levels: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    order: z.ZodOptional<z.ZodEnum<["recent", "accuracy", "popular"]>>;
+    page: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query?: string | undefined;
+    page?: number | undefined;
+    levels?: number[] | undefined;
+    order?: "recent" | "accuracy" | "popular" | undefined;
+    limit?: number | undefined;
+}, {
+    query?: string | undefined;
+    page?: number | undefined;
+    levels?: number[] | undefined;
+    order?: "recent" | "accuracy" | "popular" | undefined;
+    limit?: number | undefined;
+}>;
+export type SearchProgrammersProblemsInput = z.infer<typeof SearchProgrammersProblemsInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * 프로그래머스 문제 검색 도구 핸들러
+ *
+ * @param args - 입력 인자
+ * @returns 문제 목록 (마크다운 테이블 형식)
+ * @throws {Error} 검증 실패 또는 스크래핑 실패 시
+ */
+export declare function searchProgrammersProblems(args: unknown): Promise<TextContent>;
+/**
+ * MCP 도구 정의
+ */
+export declare function searchProgrammersProblemsTool(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        levels: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        order: z.ZodOptional<z.ZodEnum<["recent", "accuracy", "popular"]>>;
+        page: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        query: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        query?: string | undefined;
+        page?: number | undefined;
+        levels?: number[] | undefined;
+        order?: "recent" | "accuracy" | "popular" | undefined;
+        limit?: number | undefined;
+    }, {
+        query?: string | undefined;
+        page?: number | undefined;
+        levels?: number[] | undefined;
+        order?: "recent" | "accuracy" | "popular" | undefined;
+        limit?: number | undefined;
+    }>;
+    handler: typeof searchProgrammersProblems;
+};
+export {};
+//# sourceMappingURL=search-problems-programmers.d.ts.map

package/dist/tools/programmers/search-problems-programmers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-problems-programmers.d.ts","sourceRoot":"","sources":["../../../src/tools/programmers/search-problems-programmers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;EAW/C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG;;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,CA8CnF;AA0FD;;GAEG;AACH,wBAAgB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;EA4B5C"}