aeromcp 0.1.0__tar.gz

aeromcp-0.1.0/.claude/settings.local.json

@@ -0,0 +1,33 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__chrome-devtools__new_page",
+      "mcp__chrome-devtools__take_screenshot",
+      "mcp__chrome-devtools__navigate_page",
+      "mcp__chrome-devtools__take_snapshot",
+      "mcp__chrome-devtools__click",
+      "mcp__chrome-devtools__wait_for",
+      "mcp__chrome-devtools__list_network_requests",
+      "mcp__chrome-devtools__get_network_request",
+      "Bash(python3 *)",
+      "Bash(pip install *)",
+      "Bash(uv venv *)",
+      "Bash(uv pip *)",
+      "Bash(uv run *)",
+      "Bash(git init *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(python *)",
+      "Bash(.venv/bin/python *)",
+      "Bash(/opt/homebrew/bin/python3 *)",
+      "Bash(/Users/comodoflow/Documents/project/interpark-mcp/.venv/bin/python *)",
+      "Bash(/Users/comodoflow/Documents/project/interpark-mcp/.venv/bin/python3 *)",
+      "Bash(git remote *)",
+      "Bash(git push *)",
+      "mcp__chrome-devtools__evaluate_script",
+      "Bash(curl -s \"https://tour-web-assets.interparkcdn.net/applications/air/9415a7/_next/static/chunks/4356-005cbd16f663850e.js\")",
+      "Bash(curl -s \"https://tour-web-assets.interparkcdn.net/applications/air/9415a7/_next/static/chunks/pages/_app-493a23ebdbc358a9.js\")",
+      "Bash(uv build *)"
+    ]
+  }
+}

aeromcp-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.interpark/**
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+*.egg-info/

aeromcp-0.1.0/CLAUDE.md

@@ -0,0 +1,87 @@
+# interpark-mcp
+
+인터파크 항공권 조회 MCP 서버 (오픈소스).
+
+## 목적
+
+fastmcp 기반 MCP 서버. 인터파크 항공 API를 래핑해 AI 에이전트가 국내선/국제선 항공권을 조회할 수 있게 함.
+
+## 아키텍처
+
+```
+mcp/          - MCP 도구 정의 (fastmcp @mcp.tool 데코레이터)
+core/         - 도메인 모델 (dataclass), 추상 인터페이스
+infra/        - 인터파크 API 호출 구현체
+common/       - 공통 유틸, config, 상수
+dependencies/ - 컴포지트 루트. 함수 기반 의존성 주입 팩토리
+```
+
+의존 방향: `mcp → core ← infra`. infra가 core 추상 클래스를 구현.  
+`dependencies`는 core + infra 모두 참조 가능. 다른 레이어는 `dependencies`만 바라봄.
+
+## 의존성 주입 컨벤션
+
+`dependencies/`에 팩토리 함수 정의, 기본값으로 주입:
+
+```python
+# dependencies/requester.py
+def get_requester() -> Requester:
+    return InterparkRequester()
+
+# mcp/tools/search.py
+async def search_flights(
+    origin: str,
+    destination: str,
+    date: str,
+    requester: Requester = get_requester(),
+) -> list[Flight]:
+    ...
+```
+
+- 기본값이 구체 구현체 바인딩 → 호출 측은 core 추상 타입만 앎
+- 테스트 시 인자로 mock 주입 가능
+- `get_*` 함수는 순수 팩토리. 상태 없음, 매번 새 인스턴스 또는 싱글턴 반환
+
+## 인터파크 API 플로우 (국내선)
+
+검색 세션 키 획득 → 상태 폴링 → 결과 조회 순서.
+
+**1단계: 검색 세션 키 (`DOMESTIC::uuid`) 획득**
+
+Next.js SSR 엔드포인트 호출:
+```
+GET https://travel.interpark.com/air/_next/data/{buildId}/search/{routes}.json
+    ?cabin=ALL&adult=1&child=0&infant=0&schedules={encoded_routes}
+```
+
+- `buildId`: HTML `<script id="__NEXT_DATA__">` 파싱으로 추출
+- `routes` path 형식: `c:SEL-a:PUS-20260620/a:PUS-c:SEL-20260622`
+  - 편도: `a:GMP-a:CJU-20260620`
+  - SEL만 `c:` prefix (GMP/ICN 두 공항 포괄하는 도시코드). 나머지 국내 공항은 모두 `a:` prefix.
+- 응답 경로: `pageProps.dehydratedState.queries[0].state.data.key`
+
+**2단계: 상태 폴링**
+
+```
+GET /air/air-api/inpark-air-web-api/domestic/flights/search/{key}/status
+→ { "status": "PENDING" | ... }
+```
+
+**3단계: 결과 조회**
+
+```
+POST /air/air-api/inpark-air-web-api/domestic/flights/search/{key}
+Body: { "pageNumber": 1, "pageSize": 20, "filter": { "byAirline": null, ... } }
+```
+
+자세한 응답 스키마: `.interpark/domestic-flight-search.md` 참조.
+
+## 핵심 규칙
+
+- `core`는 인터파크 의존성 없음. 순수 Python dataclass + ABC.
+- `common`은 인터파크 의존성 없음. 범용 유틸만.
+- `infra`에서 HTTP 호출 시 `User-Agent` 브라우저 헤더 필수 (없으면 차단됨).
+- `buildId`는 캐시하되 HTTP 4xx 시 재추출.
+- 모든 가격 단위: 원(KRW) 정수.
+- 시각 필드: ISO 8601, TZ 없음 (한국 로컬 시각).
+- DI 팩토리 함수명: `get_{추상클래스명_snake_case}` 형식.

aeromcp-0.1.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: aeromcp
+Version: 0.1.0
+Requires-Python: >=3.11
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'

aeromcp-0.1.0/README.md

@@ -0,0 +1,152 @@
+# AeroMCP
+
+인터파크 국내선 항공권 조회 MCP 서버.
+
+AI 에이전트(Claude, Cursor 등)가 인터파크 항공 API를 통해 국내선 항공편을 검색할 수 있게 해주는 [fastmcp](https://github.com/jlowin/fastmcp) 기반 오픈소스 MCP 서버.
+
+## 기능
+
+- 국내선 편도/왕복 항공권 검색
+- 전체 항공사 조회 (티웨이, 에어부산, 대한항공 등)
+- 운임 상세 정보 (운임, 유류할증료, 공항세, 카드 캐시백 혜택)
+- 실시간 잔여석 조회
+
+## 설치
+
+### uvx (권장)
+
+```bash
+uvx aeromcp
+```
+
+### pip
+
+```bash
+pip install aeromcp
+```
+
+### 직접 실행
+
+```bash
+git clone https://github.com/bssm-oss/AeroMCP.git
+cd AeroMCP
+pip install -e .
+interpark-mcp
+```
+
+## MCP 클라이언트 설정
+
+### Claude Desktop / Cursor
+
+`claude_desktop_config.json` 또는 `mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "interpark": {
+      "command": "uvx",
+      "args": ["aeromcp"]
+    }
+  }
+}
+```
+
+pip 설치 시:
+
+```json
+{
+  "mcpServers": {
+    "interpark": {
+      "command": "interpark-mcp"
+    }
+  }
+}
+```
+
+## 사용 가능한 도구
+
+### `search_domestic_flights`
+
+국내선 항공권을 검색합니다.
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| `origin` | string | ✓ | 출발 IATA 코드 (예: `GMP`, `SEL`) |
+| `destination` | string | ✓ | 도착 IATA 코드 (예: `CJU`, `PUS`) |
+| `departure_date` | string | ✓ | 출발일 `YYYY-MM-DD` |
+| `return_date` | string | | 귀국일 `YYYY-MM-DD` (왕복 시) |
+| `adult` | int | | 성인 수 (기본값 1) |
+| `child` | int | | 소아 수 (기본값 0) |
+| `infant` | int | | 유아 수 (기본값 0) |
+
+**응답 필드:**
+
+```json
+{
+  "id": "TW0933L",
+  "total_price": 68900,
+  "departure": "GMP",
+  "arrival": "CJU",
+  "departure_at": "2026-06-20T11:50:00",
+  "arrival_at": "2026-06-20T12:55:00",
+  "carrier": "TW",
+  "flight_number": "0933",
+  "flight_time_minutes": 65,
+  "free_baggage_kg": 15,
+  "seat_availability": 9,
+  "cabin": "ECONOMY",
+  "discount_type": "DISCOUNT",
+  "cashback": {
+    "card_name": "삼성카드",
+    "rate": 1.5,
+    "amount": 1010,
+    "discounted_price": 67890
+  }
+}
+```
+
+## 공항 코드
+
+| 코드 | 도시/공항 | 비고 |
+|------|-----------|------|
+| `SEL` | 서울 | 도시 코드 (GMP + ICN 통합) |
+| `GMP` | 서울/김포 | |
+| `ICN` | 서울/인천 | |
+| `CJU` | 제주 | |
+| `PUS` | 부산/김해 | |
+| `KWJ` | 광주 | |
+| `MWX` | 무안 | |
+| `KUV` | 군산 | |
+| `TAE` | 대구 | |
+| `HIN` | 진주/사천 | |
+| `RSU` | 여수 | |
+| `USN` | 울산 | |
+| `WJU` | 원주 | |
+| `CJJ` | 청주 | |
+| `KPO` | 포항 | |
+| `YNY` | 양양 | |
+
+## 아키텍처
+
+```
+mcp/          - FastMCP 도구 정의
+core/         - 도메인 모델 (dataclass), 추상 인터페이스
+infra/        - 인터파크 API 호출 구현체
+common/       - 설정 상수, 브라우저 헤더
+dependencies/ - 의존성 주입 팩토리
+```
+
+의존 방향: `mcp → core ← infra`
+
+## 개발
+
+```bash
+git clone https://github.com/bssm-oss/AeroMCP.git
+cd AeroMCP
+pip install -e ".[dev]"
+pytest
+```
+
+## 라이선스
+
+MIT