Metadata-Version: 2.4
Name: trip-planner-mcp
Version: 4.12.0
Summary: 여행 숙소, 항공편, 관광지 검색 + 구조화 활동 관리 MCP 서버 (20개 도구)
Author: idean3885
License-Expression: MIT
Project-URL: Homepage, https://github.com/idean3885/trip-planner
Project-URL: Repository, https://github.com/idean3885/trip-planner
Keywords: travel,booking,mcp,claude-code,hotels,flights,attractions,itinerary,planner
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.2.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pytest-httpx>=0.30.0; extra == "dev"
Requires-Dist: towncrier>=24.8.0; extra == "dev"

# 우리의 여행 ✈️

대화로 만드는 여행 플래너. 일정·숙소·활동을 한곳에 모아 동행자와 함께 모바일에서 바로 열어 씁니다.

**[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
