Startup Helper MCP

Instructions

Implementation Reference

• src/tools/policy-funds.ts:170-220 (handler)

  Main handler function implementing the recommend_policy_funds tool logic: matches policy funds to user criteria using helpers, generates tips, and formats ApiResult response.
  export async function recommendPolicyFunds( businessType: string, stage: "예비창업" | "초기창업" | "운영중" | "재창업", region: string, founderType?: "청년" | "중장년" | "여성" | "장애인" | "일반", founderAge?: number ): Promise<ApiResult<PolicyFundRecommendation>> { try { // 조건에 맞는 지원금 매칭 const matchedFunds = matchFunds( businessType, stage, region, founderType, founderAge ); // 추천 팁 생성 const tip = generateTip(matchedFunds, stage, founderType); return { success: true, data: { userProfile: { businessType, stage, region, founderType, }, matchedFunds, totalCount: matchedFunds.length, tip, }, meta: { source: DATA_SOURCES.bizinfoApi, timestamp: new Date().toISOString(), }, }; } catch (error) { console.error("정책지원금 추천 실패:", error); return { success: false, error: { code: "POLICY_FUND_FAILED", message: `정책지원금 조회 중 오류가 발생했습니다.`, suggestion: "기업마당(bizinfo.go.kr)에서 직접 검색해보세요.", }, }; } }
• src/index.ts:61-87 (registration)

  MCP server.tool registration for 'recommend_policy_funds', including description, Zod input schema, and wrapper that calls the handler.
  server.tool( "recommend_policy_funds", "창업자 조건에 맞는 정부/지자체 정책지원금을 추천합니다. 융자, 보조금, 멘토링 프로그램 등을 안내합니다.", { business_type: z.string().describe("창업 업종 (예: 카페, 음식점, IT서비스)"), stage: z.enum(["예비창업", "초기창업", "운영중", "재창업"]).describe("창업 단계"), region: z.string().describe("창업 지역 (예: 서울, 경기 성남, 부산)"), founder_type: z .enum(["청년", "중장년", "여성", "장애인", "일반"]) .optional() .describe("창업자 유형"), founder_age: z.number().optional().describe("창업자 나이"), }, async ({ business_type, stage, region, founder_type, founder_age }) => { const result = await recommendPolicyFunds( business_type, stage, region, founder_type, founder_age ); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], isError: !result.success, }; } );
• src/types.ts:72-95 (schema)

  TypeScript interfaces defining the PolicyFund and PolicyFundRecommendation structures used for input/output schema of the tool.
  export interface PolicyFund { id: string; name: string; organization: string; amount: string; type: "융자" | "보조금" | "멘토링" | "교육" | "복합"; deadline?: string; requirements: string[]; applyUrl: string; description?: string; } // 정책지원금 추천 결과 export interface PolicyFundRecommendation { userProfile: { businessType: string; stage: string; region: string; founderType?: string; }; matchedFunds: PolicyFund[]; totalCount: number; tip: string; }
• src/tools/policy-funds.ts:99-139 (helper)

  Helper function that filters the POLICY_FUNDS_DB based on business type, stage, region, founder type, and age.
  function matchFunds( businessType: string, stage: string, region: string, founderType?: string, founderAge?: number ): PolicyFund[] { return POLICY_FUNDS_DB.filter((fund) => { // 청년 조건 체크 if (fund.requirements.some((r) => r.includes("39세 이하"))) { if (founderAge && founderAge > 39) return false; if (founderType && !["청년", "일반"].includes(founderType)) { // 청년이 아니면 제외할 수 있지만, 나이 정보 없으면 포함 if (founderType === "중장년") return false; } } // 중장년 조건 체크 if (fund.requirements.some((r) => r.includes("40세 이상"))) { if (founderAge && founderAge < 40) return false; if (founderType === "청년") return false; } // 여성 조건 체크 if (fund.requirements.some((r) => r.includes("여성"))) { if (founderType && founderType !== "여성") return false; } // 지역 조건 체크 if (fund.requirements.some((r) => r.includes("서울"))) { if (region && !region.includes("서울")) return false; } // 폐업자 조건 체크 if (fund.requirements.some((r) => r.includes("폐업"))) { if (stage !== "재창업") return false; } return true; }); }
• src/tools/policy-funds.ts:142-168 (helper)

  Helper function that generates contextual tips based on matched funds, stage, and founder type.
  function generateTip( matchedFunds: PolicyFund[], stage: string, founderType?: string ): string { if (matchedFunds.length === 0) { return "현재 조건에 맞는 지원사업이 없습니다. 조건을 변경하거나 기업마당(bizinfo.go.kr)에서 직접 검색해보세요."; } const hasMentoring = matchedFunds.some((f) => f.type === "복합" || f.type === "멘토링"); const hasGrant = matchedFunds.some((f) => f.type === "보조금"); const hasLoan = matchedFunds.some((f) => f.type === "융자"); if (stage === "예비창업" && hasMentoring) { return "예비창업자는 멘토링이 포함된 프로그램(창업사관학교 등)을 추천드립니다. 창업 성공률을 높일 수 있습니다."; } if (hasGrant && hasLoan) { return "보조금은 상환 의무가 없어 유리하지만 경쟁률이 높습니다. 융자와 보조금을 함께 준비하세요."; } if (founderType === "청년") { return "청년 대상 지원사업이 많습니다. 여러 개를 동시에 신청하면 선정 확률이 높아집니다."; } return "신청 기한을 확인하고 서류를 미리 준비하세요. 사업계획서 작성이 가장 중요합니다."; }