🚀 Startup Helper MCP

<div align="center">

AI 창업 컨설턴트 - 상권분석부터 정책지원금까지 창업의 모든 것

"창업 준비, 4개 사이트 돌아다니지 마세요. 한 번의 대화로 끝내세요."

데모 보기 • 설치하기 • 사용법

</div>

---

🎯 왜 만들었나요?

창업 준비의 현실

예비 창업자 김청년(29세)씨의 하루:

09:00 - 상권정보시스템에서 강남역 상권 검색... 회원가입 필요
10:00 - 카카오맵에서 경쟁 카페 하나하나 세기... 23개째...
11:00 - 기업마당에서 청년 창업 지원금 검색... 뭐가 이렇게 많아?
12:00 - 구청 홈페이지에서 카페 인허가 절차 확인... 어디있지?
13:00 - 아직 점심도 못 먹었는데 정보는 반도 못 모음...

4개 사이트, 반나절, 그래도 부족한 정보.

---

✨ Startup Helper MCP를 쓰면

사용자: "나 29살인데 강남역에서 카페 창업하려고 해. 자본금 5천만원 있어."

AI: [5개 Tool 자동 호출]

📊 강남역 카페 창업 종합 리포트

1️⃣ 트렌드: 일반 카페 -5% 하락세, 스터디카페 +15% 상승
2️⃣ 상권: 발달상권, 카페 포화도 87% (높음)
3️⃣ 경쟁: 반경 300m 카페 23개, 프랜차이즈 65%
4️⃣ 지원금: 청년창업사관학교 최대 1억, 서울시 청년창업 3천만원
5️⃣ 인허가: 영업신고증, 위생교육, 소방점검 필요

💡 종합: 강남역은 포화 상태. 논현역 방면(포화도 62%) 검토 추천

한 번의 대화, 5분, 완벽한 분석.

---

📊 Before vs After

구분	기존 방식	Startup Helper MCP
소요 시간	반나절~하루	5분
필요 사이트	4개+	0개 (대화만)
정보 통합	직접 종합	AI가 자동 분석
맞춤 추천	없음	조건별 맞춤 제공
인사이트	데이터만	액션 가이드 포함

---

🛠️ 제공 Tool (5개)

1. analyze_commercial_area - 상권 분석

특정 위치의 상권을 분석합니다. 업종별 밀집도, 포화도, 상권 특성을 제공합니다.

{ "location": "강남역", "business_type": "카페", "radius": 500 }

결과: 상권 유형, 포화도 점수, 특성 분석, 진입 추천

2. find_competitors - 경쟁업체 검색

주변 경쟁업체를 검색하고 프랜차이즈 비율, 시장 진입 여지 등을 분석합니다.

{ "location": "홍대입구", "business_type": "음식점", "radius": 300 }

결과: 경쟁업체 목록, 프랜차이즈 비율, 평균 거리, 시장 분석

3. recommend_policy_funds - 정책지원금 추천

창업자 조건에 맞는 정부/지자체 정책지원금을 추천합니다.

{ "business_type": "카페", "stage": "예비창업", "region": "서울", "founder_type": "청년", "founder_age": 28 }

결과: 맞춤 지원금 목록, 신청 자격, 지원 금액, 신청 방법

4. get_startup_checklist - 창업 체크리스트

업종별 필요 인허가, 예상 비용, 준비 순서를 안내합니다.

{ "business_type": "음식점", "region": "서울" }

결과: 인허가 목록, 예상 비용, 단계별 체크리스트

5. get_business_trends - 창업 트렌드

최근 창업 트렌드와 업종별 성장/쇠퇴 현황을 분석합니다.

{ "region": "전국", "category": "카페" }

결과: 성장 업종, 하락 업종, 트렌드 인사이트

---

💬 사용 예시

예시 1: 청년 카페 창업

"나 29살인데 강남역에서 카페 창업하려는데 분석해줘"
→ 트렌드 + 상권 + 경쟁 + 지원금 + 체크리스트 종합 분석

예시 2: 업종 고민

"요즘 뭐 창업하면 잘돼?"
→ 성장 업종 TOP 7, 하락 업종, 트렌드 인사이트

예시 3: 지원금 검색

"청년 창업 지원금 뭐 있어?"
→ 조건별 맞춤 지원금 추천

예시 4: 경쟁 분석

"홍대 근처 음식점 경쟁 어때?"
→ 경쟁업체 수, 프랜차이즈 비율, 진입 여지 분석

---

🎯 타겟 사용자

페르소나	니즈	Startup Helper가 주는 가치
예비 창업자	어디서 뭘 해야 할지 모름	원스톱 정보 + 가이드
소상공인	상권 이동/업종 전환 고민	데이터 기반 의사결정
창업 컨설턴트	고객 상담 자료 필요	빠른 리서치 자동화
프랜차이즈 본사	신규 입점 후보지 분석	상권 스크리닝

---

☁️ 배포

Render (현재 운영 중)

https://startup-helper-mcp.onrender.com

로컬 설치

# 설치
pnpm install

# 환경 변수 설정
echo "KAKAO_API_KEY=your_key" > .env

# 실행
pnpm dev        # stdio 모드
pnpm dev:http   # HTTP/SSE 모드

Claude Desktop 연동

%APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "startup-helper": {
      "url": "https://startup-helper-mcp.onrender.com/sse"
    }
  }
}

---

🔑 사용 API

API	용도	데이터
카카오맵 로컬 API	장소 검색, 좌표 변환	실시간
소상공인시장진흥공단 API	상권 통계	준실시간
기업마당 API	정책지원금	준실시간

---

📁 프로젝트 구조

src/
├── index.ts                 # MCP 서버 (stdio + HTTP/SSE)
├── constants.ts             # 상수 정의
├── types.ts                 # TypeScript 타입
├── api/
│   └── kakao-api.ts         # 카카오맵 API 클라이언트
├── tools/
│   ├── commercial-area.ts   # 상권 분석
│   ├── competitors.ts       # 경쟁업체 검색
│   ├── policy-funds.ts      # 정책지원금 추천
│   ├── startup-checklist.ts # 창업 체크리스트
│   └── business-trends.ts   # 창업 트렌드
└── tests/                   # 테스트 코드

---

✅ 품질

항목	상태
TypeScript	✅ 타입 안전
ESLint	✅ 코드 품질
Vitest	✅ 10개 테스트 통과
Rate Limiting	✅ 100 req/min
Error Handling	✅ 한글 에러 메시지
Graceful Shutdown	✅ SIGTERM/SIGINT

---

🏆 차별화 포인트

1. 원스톱 솔루션 - 4개 사이트 정보를 한 번의 대화로
2. 카카오 API 중심 - 카카오맵 로컬 API 핵심 활용
3. 맥락 기반 분석 - 단순 데이터가 아닌 인사이트 제공
4. 맞춤 추천 - 창업자 조건별 필터링
5. 한글 UX - 모든 메시지 한글화

---

📄 라이선스

MIT License

---

<div align="center">

Kakao PlayMCP 공모전 출품작

Made with ❤️ for Korean Entrepreneurs

</div>