trip-planner-mcp

# 우리의 여행 ✈️ 대화로 만드는 여행 플래너. 일정·숙소·활동을 한곳에 모아 동행자와 함께 모바일에서 바로 열어 씁니다. **[trip.idean.me](https://trip.idean.me)** 에 접속하면 프로젝트 랜딩을 먼저 만나고, Google 로그인 한 번으로 바로 쓸 수 있습니다. ## 이 프로젝트는 > **AI 에이전트와 바이브 코딩으로 만든 개인 여행 플래너.** > 자연어로 **검색**하고 → 웹·API로 일정을 **생성**해 → 동행자와 함께 **플래닝**하고 → 현장에선 소소한 **가계부**가 됩니다. 같이 갈 사람과 대화로 여행을 계획하고, 웹에서 함께 다듬어 현장까지 들고 가는 개인 프로젝트입니다. 어떤 기술로 만들었고 어떻게 운영하는지는 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)에 정리해 두었습니다. ## 어디로 가시나요 ### 써보고 싶은 분 (외부 방문자) 위 링크 한 개로 충분합니다 — 랜딩에서 시작 CTA를 누르면 Google 로그인 → 여행 생성으로 바로 이어집니다. - 프로젝트 전반 소개는 랜딩 하단의 **프로젝트 소개** 링크(About 페이지)에서 더 자세히 읽을 수 있습니다 - AI 에이전트까지 쓰고 싶다면 아래 **빠른 시작**의 한 줄 curl을 보세요 ### 기술이 궁금하신 분 구조가 궁금하면 **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** 한 문서면 됩니다. 시스템 구성도·주요 흐름·도메인·데이터 스키마를 그림 위주로 봅니다. 스펙을 어떻게 관리하는지(speckit)도 같은 문서에 짧게 언급돼 있습니다. 코드까지 들어가려면 개발 문서 목차 **[docs/README.md](docs/README.md)** 에서 세팅·도메인·업무 프로세스로 이어집니다. ## 빠른 시작 ```bash # AI 에이전트(MCP) 설치 — 맥북 1줄 curl -sSL https://raw.githubusercontent.com/idean3885/trip-planner/main/scripts/install.sh | bash ``` 설치 중 브라우저가 열리면 Google 로그인만 하세요. 토큰이 자동 저장됩니다. 이후 Claude에게 자연어로 요청하면 됩니다 — 예) *"포르투 6월 10일 리스본행 항공편 찾아줘"*, *"3일차 벨렘탑 09:00~11:00 추가해줘"*. 웹에서만 쓰고 싶다면 위 "써보고 싶은 분" 섹션의 링크로 바로 들어가면 됩니다. ### 구글 캘린더 연동 제약 (현재 심사 전 단계) 본 앱은 아직 앱 심사 전 단계라, **개발자가 직접 허용한 Google 계정**(최대 100명)만 구글 캘린더 연동을 사용할 수 있습니다. 앱 내 일정 조회·편집은 누구나 정상 이용 가능하며, 연동만 등록 사용자에게 한정됩니다. 연동 등록을 원하시면 [공개 토론 채널의 Q&A](https://github.com/idean3885/trip-planner/discussions/new?category=q-a)에 가입 Google 이메일을 남겨 주세요. ## 링크 | | | |---|---| | 랜딩·웹앱 | [trip.idean.me](https://trip.idean.me) | | 저장소 | [github.com/idean3885/trip-planner](https://github.com/idean3885/trip-planner) | | 개발 문서 | [docs/README.md](docs/README.md) | | 변경 이력 | [CHANGELOG.md](CHANGELOG.md) | | 업무 프로세스 | [docs/WORKFLOW.md](docs/WORKFLOW.md) | --- **License**: MIT · **Author**: idean3885