Korea Trip Concierge 🇰🇷

방한 외국인이 한국에서 막히는 지점(장소탐색·외국인 친화 매장·교통·결제)을 영어로 구조화해 해결하는 MCP 서버. 카카오 Agentic Player 10 공모전 출품작.

Repo: https://github.com/bb4rjfl/korea-trip-concierge · TypeScript + Node 22 · MCP SDK 1.29 · Streamable HTTP (stateless)

개발 / 실행

npm install
npm run build      # 네이밍 린트(kakao 금지) + tsc
npm test           # vitest (77)
npm run dev        # tsx watch (로컬 서버, POST /mcp)
npm start          # node dist/server.js

API 키는 .env.example를 복사해 .env에 설정 (발급법: docs/08_api_key_issuance.md). 키 없이도 지식 툴 3종은 동작.

Related MCP server: Naver Search MCP Server

이 저장소를 처음 여는 사람(또는 Claude Code)에게

1. CLAUDE.md 부터 읽으세요. 프로젝트 헌법이자 모든 컨텍스트의 진입점입니다.

2. 규칙은 docs/01_kakao_playmcp_rules.md (절대 규칙 — 어기면 심사 반려).

3. 무엇을 만드는지는 docs/02_product_spec.md, 어떻게는 docs/03~05.

4. 진행 상황은 docs/07_progress.md (단일 진실 소스).

문서 맵

Claude Code 슬래시 커맨드

• /sync 세션 시작(컨텍스트 로드 + 다음 할 일)

• /newtool 새 툴 일관 추가

• /check 응모 전 카카오 규칙 점검

• /handoff 세션 종료(문서 최신화)

핵심 제약 (요약)

• 서버명·툴명에 kakao 금지 · Streamable HTTP · Remote · Stateless

• 툴 3~10개 · annotations 5종 · 영문 description · 응답 Markdown ≤24k

• p99 3s · 광고/리워드 금지 · 개인정보 6종 금지

• 푸시 불가 → 모든 알림은 조회+새로고침 칩으로

• LLM 웹검색으로 대체 가능한 기능 금지 → 실시간/연동/구조화 가치 필수

일정 (역산)

6월 말 1차 배포 → 7/7 심사요청 마감 → 전체공개 → 7/14 비즈폼 응모