wanderlog-mcp

Claude(또는 모든 MCP 호환 에이전트)가 대화를 통해 Wanderlog 여행 일정을 확인하고 구축할 수 있게 해주는 MCP 서버입니다.

Wanderlog UI를 클릭하며 여행을 계획하는 대신, 다음과 같이 요청하기만 하면 됩니다:

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

에이전트가 도구를 호출하여 각 날짜에 장소와 메모를 배치하고, 호텔 블록과 체크리스트를 추가하면 몇 분 안에 완벽하게 구성된 Wanderlog 여행 일정이 완성됩니다.

실제 예시 보기: 14일간의 일본 골든 루트 — 이 MCP 서버를 사용하여 AI 에이전트가 완전히 구축했습니다.

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를 눌러 개발자 도구를 엽니다.

3. Application(애플리케이션) 탭을 클릭합니다.

4. 왼쪽 사이드바에서 **Storage(저장소) → Cookies(쿠키) → https://wanderlog.com**을 확장합니다.

5. **Name(이름)**이 connect.sid인 행을 찾습니다.

6. 해당 행을 클릭한 다음, Value(값) 셀을 더블 클릭하여 전체 문자열을 복사합니다. s%3A로 시작하며 약 100자 길이입니다.

Firefox

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

2. F12를 눌러 개발자 도구를 엽니다.

3. Storage(저장소) 탭을 클릭합니다.

4. 왼쪽 사이드바에서 **Cookies(쿠키) → https://wanderlog.com**을 확장합니다.

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

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

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

Settings → MCP → Add server를 선택하거나 ~/.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 개발자 도구에서 새로운 connect.sid 쿠키를 캡처하여 MCP 구성의 WANDERLOG_COOKIE를 업데이트하세요.

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

문제 해결

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

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를 호출하여 작동하므로 예고 없이 변경될 수 있습니다. 사용 시 위험은 사용자 본인에게 있습니다.

라이선스

MIT — LICENSE 참조

제작자: shaikhspeare