wanderlog-mcp

Claude(또는 MCP 호환 에이전트)가 대화를 통해 Wanderlog 여행 일정을 조회하고 만들 수 있게 해주는 MCP 서버입니다.

Wanderlog UI를 클릭하며 여행을 계획하는 대신, 그냥 이렇게 물어보면 됩니다:

"14일 일본 골든 루트 여행을 만들어 줘 — 도쿄, 하코네, 교토, 나라, 오사카."

에이전트가 도구를 호출하여 각 날짜에 장소와 메모를 섞어 넣고, 호텔 블록, 페리, 버스, 기차, 렌터카, 체크리스트를 추가하면 몇 분 안에 완전히 채워진 Wanderlog 여행 일정이 완성됩니다.

실제 예시 보기: 14일 일본 골든 루트 — 이 MCP 서버를 사용하여 AI 에이전트가 전적으로 만든 여행 일정입니다.

새로운 기능 (미출시)

• wanderlog_search_hotels — airbnb, expedia, google, kayak의 Wanderlog 호텔 통합 검색을 제공합니다. 공급업체별 가격 비교와 패싯 필터 탐색이 포함된 순위별 오퍼를 반환하므로 LLM이 Wanderlog 내부 enum 값을 외울 필요가 없습니다.

• 시작 시 인증 프로브가 실패하면 첫 번째 도구 호출에서 공유 재시도가 한 번 이루어져, 유효한 세션이 서버를 재시작하지 않고도 일시적인 네트워크 또는 프록시 오류에서 복구될 수 있습니다.

Related MCP server: kyoto-assistant-mcp

v0.3.1의 새로운 기능

• Wanderlog는 빠른 편집을 속도 제한합니다. 전체 일정을 만드는 LLM과 같은 폭발적인 변경은 불투명한 "Submit op timeout" 오류로 실패하는 대신 백오프와 함께 자동으로 재시도됩니다.

• 재시도할 수 없는 속도 제한 거부는 10초 동안 멈추는 대신 명확한 오류로 표시됩니다.

• wanderlog_update_trip_dates로 생성된 새 날짜 섹션이 이제 Wanderlog의 기본 섹션 형태와 정확히 일치합니다.

v0.3.0의 새로운 기능

• wanderlog_search_guides + wanderlog_get_guide — 사용자가 작성한 Wanderlog 여행 가이드를 발견하고 읽습니다. LLM은 "베트남에 어떤 가이드가 있나요?"라고 물어보고 전체 일정을 가져와 영감으로 사용할 수 있습니다.

• wanderlog_remove_note — 자연어 참조로 독립형 메모 블록을 제거합니다.

• wanderlog_edit_note — 메모 블록, 장소 주석, 체크리스트 제목/항목에서 찾아 바꾸기를 수행합니다.

• 상세 모드에서 더 이상 장소 메모나 메모 블록을 자르지 않습니다. 가이드와 일정의 전체 설명이 렌더링됩니다.

• 수정 사항: 임베드를 포함한 메모가 더 이상 [object Object]로 렌더링되지 않습니다. 장소 참조는 이제 하이픈/대시 차이를 무시하고 일치합니다(예: "Roppongi Hills - Tokyo City View").

v0.2.0의 새로운 기능

• wanderlog_rename_day — 자동 생성된 날짜 제목(예: "Barcelona")을 설명적인 제목("Arrival — Feria de Abril")으로 바꿉니다. ""를 전달하면 기본값으로 재설정됩니다.

• 도구 표에 이제 wanderlog_annotate_place와 wanderlog_add_expense가 문서화되었습니다(이전에 출시되었으나 v0.1.0 문서에는 누락).

v0.1.0의 새로운 기능

• 단일 대화에서 장소, 메모, 호텔, 체크리스트를 포함한 전체 일정 작성

• wanderlog_search_places — Wanderlog의 장소 데이터베이스를 사용하여 모든 목적지 주변의 실제 장소를 검색합니다

• wanderlog_add_note — 장소 사이에 교통 팁, 예약 정보, 현지 조언을 섞어 넣습니다

• wanderlog_add_checklist — 여행 전 및 날짜별 체크리스트(비자, 통화, 시간 지정 입장권)

• 시작 시 MCP 서버 지침이 주입되어 Claude가 완전한 일정을 자동으로 작성합니다

• 시작 인증 프로브 — 대화 중간에 실패하는 대신 만료된 쿠키를 즉시 감지합니다

예시 프롬프트

"What trips do I have in Wanderlog?"

"Create a 7-day itinerary for Lisbon starting June 1 — include restaurants, day trips,
and a hotel near the waterfront."

"Add a day trip to Sintra on day 3 of my Lisbon trip."

"I'm spending 5 days in Tokyo — build me a full itinerary with museum visits, ramen spots,
and a ryokan in Shinjuku."

"Look at my Barcelona trip and add practical notes for getting between each place."

"Add a pre-trip checklist to my Paris trip — visa, currency, offline maps, travel insurance."

"Move my Rome trip back by two weeks."

"Give me the shareable link to my Kyoto itinerary."

"Remove the Colosseum from day 2 of my Rome trip."

도구

사전 요구 사항

• Node.js 22 이상

• Wanderlog 계정

• MCP 호환 클라이언트: Claude Code, Claude Desktop, OpenAI Codex, Cursor, VS Code 또는 모든 stdio MCP 호스트

설정

1단계 — Wanderlog 세션 쿠키 가져오기

Wanderlog에는 공개 API가 없으므로 wanderlog-mcp는 브라우저 세션 쿠키(connect.sid)를 사용하여 인증합니다. 이 쿠키는 약 1년 동안 유효하며 사용자의 컴퓨터를 벗어나지 않습니다.

비밀번호처럼 취급하세요 — Wanderlog UI에서 가지고 있는 것과 동일한 액세스 권한을 부여합니다.

Chrome / Edge

1. wanderlog.com에 접속하여 로그인합니다

2. F12를 눌러 DevTools를 엽니다

3. Application 탭을 클릭합니다

4. 왼쪽 사이드바에서 **Storage → Cookies → https://wanderlog.com**을 펼칩니다

5. Name이 connect.sid인 행을 찾습니다

6. 행을 클릭한 다음 Value 셀을 더블클릭하고 전체 문자열을 복사합니다 — s%3A로 시작하며 길이는 ~100자입니다

Firefox

1. wanderlog.com에 접속하여 로그인합니다

2. F12를 눌러 DevTools를 엽니다

3. Storage 탭을 클릭합니다

4. 왼쪽 사이드바에서 **Cookies → https://wanderlog.com**을 펼칩니다

5. 테이블에서 connect.sid를 찾아 클릭하고 Value를 복사합니다

콘솔에서 document.cookie를 사용할 수 없는 이유는 무엇인가요? Wanderlog는 connect.sid를 HttpOnly 플래그로 설정하여 JavaScript가 이를 읽는 것을 의도적으로 차단합니다(XSS 보호). DevTools는 이 제한을 우회하므로 콘솔에서는 안 되지만 DevTools에서는 작동하는 것입니다.

2단계 — MCP 클라이언트 구성

Claude Code

claude mcp add wanderlog-mcp npx wanderlog-mcp \
  --env WANDERLOG_COOKIE="s%3A...your value here..."

Claude Desktop

claude_desktop_config.json을 편집합니다:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

저장한 후 Claude Desktop을 다시 시작합니다.

Cursor

설정 → MCP → 서버 추가, 또는 ~/.cursor/mcp.json을 편집합니다:

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

VS Code (GitHub Copilot)

작업 공간의 .vscode/mcp.json에 추가합니다:

{
  "servers": {
    "wanderlog": {
      "type": "stdio",
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

OpenAI Codex

~/.codex/config.toml을 편집합니다:

[mcp_servers.wanderlog]
command = "npx"
args = ["wanderlog-mcp"]

[mcp_servers.wanderlog.env]
WANDERLOG_COOKIE = "s%3A...your value here..."

Codex에서 /mcp를 실행하여 서버가 로드되었는지 확인합니다.

Smithery (원클릭 설치)

npx @smithery/cli install wanderlog-mcp --client claude

3단계 — 확인

에이전트에게 물어보세요: "Wanderlog에 어떤 여행이 있나요?"

wanderlog_list_trips를 호출하여 계정의 여행 목록을 반환해야 합니다. 실패하면 아래의 문제 해결을 참조하세요.

쿠키 새로고침

쿠키는 약 1년 동안 유지되지만 wanderlog.com에서 로그아웃하거나 비밀번호를 변경하거나 Wanderlog가 세션을 취소하면 더 일찍 만료될 수 있습니다. 이 경우 모든 도구 호출이 다음을 반환합니다:

Wanderlog 세션이 유효하지 않거나 만료됨 — wanderlog.com DevTools에서 새 connect.sid 쿠키를 캡처하고 MCP 구성의 WANDERLOG_COOKIE를 업데이트하세요.

위의 1단계를 반복하고 구성을 업데이트한 다음 MCP 클라이언트를 다시 시작합니다.

문제 해결

서버는 시작되지만 list_trips가 인증 오류를 반환합니다 쿠키가 만료되었거나 잘못되었습니다. DevTools에서 다시 캡처하고 구성을 업데이트하세요.

npx wanderlog-mcp가 멈추거나 아무것도 하지 않습니다 서버는 stdio MCP를 사용합니다. 터미널에서 직접 실행하는 것이 아니라 MCP 호스트에 의해 실행되도록 설계되었습니다. 위에서 설명한 대로 Claude Code 또는 Claude Desktop을 통해 실행하세요.

도구는 작동하지만 에이전트가 메모/체크리스트를 무시합니다 서버는 MCP initialize 응답에 지침을 주입하여 에이전트가 장소와 메모를 섞어 넣고 체크리스트를 추가하도록 안내합니다. 이는 Claude에서 안정적으로 작동합니다. 다른 클라이언트는 다를 수 있습니다.

보안

• 쿠키는 MCP 클라이언트 구성에만 저장되며, 커밋되거나 로그에 기록되지 않습니다

• wanderlog-mcp는 전적으로 사용자 머신에서 실행됩니다 — 중계 서버가 없습니다

• 시작 시 인증 프로브는 쿠키 값을 출력하지 않고 쿠키를 검증합니다

• 액세스를 취소하려면: wanderlog.com에서 로그아웃(모든 세션 무효화)한 후 다시 캡처하세요

기여

풀 리퀘스트를 환영합니다. 제출 전에:

npm run build && npm run test

전송 또는 도구 코드 변경 시에는 다음도 실행하세요:

npm run test:integration

고지 사항

wanderlog-mcp는 비공식 서드파티 도구로, Wanderlog와 제휴하거나 보증하지 않습니다. Wanderlog의 비공개 웹 클라이언트 API를 호출하여 작동하며, 이 API는 예고 없이 변경될 수 있습니다. 사용에 따른 책임은 사용자에게 있습니다.

라이선스

MIT — LICENSE 참조

shaikhspeare 제작