wanderlog-mcp

MCP-сервер, который позволяет Claude (или любому MCP-совместимому агенту) просматривать и создавать маршруты поездок Wanderlog через разговор.

Вместо того чтобы кликать по интерфейсу Wanderlog для планирования поездки, вы просто спрашиваете:

«Создайте 14-дневную поездку по Золотому маршруту Японии — Токио, Хаконе, Киото, Нара и Осака.»

Агент вызывает инструменты, чередует места и заметки для каждого дня, добавляет блоки отелей, паромы, автобусы, поезда, арендованные автомобили и чек-листы, и вы получаете полностью заполненную поездку Wanderlog за несколько минут.

Посмотрите реальный пример: 14-дневный Золотой маршрут Японии — создан полностью ИИ-агентом с использованием этого MCP-сервера.

Что нового (не выпущено)

• wanderlog_search_hotels — поиск по агрегатору отелей Wanderlog среди airbnb, expedia, google и kayak. Возвращает ранжированные предложения с сравнением цен по поставщикам и обнаружением фасетных фильтров, чтобы LLM не приходилось запоминать внутренние значения перечислений Wanderlog.

• Неудачная проверка аутентификации при запуске теперь получает одну общую повторную попытку при первом вызове инструмента, что позволяет действительным сессиям восстановиться после временной сетевой ошибки или ошибки прокси без перезапуска сервера.

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 автоматически создавал полные маршруты

• Проверка аутентификации при запуске — немедленно обнаруживает истёкшие cookie вместо сбоя в середине разговора

Примеры запросов

"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 — Получите cookie сессии Wanderlog

У Wanderlog нет публичного API, поэтому wanderlog-mcp аутентифицируется с помощью cookie сессии вашего браузера (connect.sid). Он действителен примерно год и никогда не покидает ваш компьютер.

Относитесь к нему как к паролю — он предоставляет тот же доступ, что и в интерфейсе Wanderlog.

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 обходит это ограничение — поэтому он работает, а консоль — нет.

Шаг 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..."

Запустите /mcp внутри Codex, чтобы подтвердить загрузку сервера.

Smithery (установка в один клик)

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

Шаг 3 — Проверка

Спросите вашего агента: «Какие поездки у меня есть в Wanderlog?»

Он должен вызвать wanderlog_list_trips и вернуть поездки вашего аккаунта. Если это не сработает, см. Устранение неполадок ниже.

Обновление cookie

Cookie действует около года, но может истечь раньше, если вы выйдете из wanderlog.com, смените пароль или Wanderlog отзовёт сессию. В этом случае каждый вызов инструмента возвращает:

Сессия Wanderlog недействительна или истекла — Получите свежую cookie connect.sid из DevTools wanderlog.com и обновите WANDERLOG_COOKIE в вашей конфигурации MCP.

Повторите Шаг 1 выше, обновите конфигурацию и перезапустите ваш MCP-клиент.

Устранение неполадок

Сервер запускается, но list_trips возвращает ошибку аутентификации Ваша cookie истекла или неверна. Захватите её заново из DevTools и обновите конфигурацию.

npx wanderlog-mcp зависает или ничего не делает Сервер использует stdio MCP — он предназначен для запуска MCP-хостом, а не для прямого запуска в терминале. Запустите его через Claude Code или Claude Desktop, как описано выше.

Инструменты работают, но агент игнорирует заметки/чек-листы Сервер внедряет инструкции в ответ MCP initialize, которые сообщают агенту о необходимости чередовать места и заметки и добавлять чек-листы. Это надёжно работает с Claude. Другие клиенты могут отличаться.

Безопасность

• Cookie хранится только в конфигурации вашего MCP-клиента и никогда не коммитится и не логируется

• wanderlog-mcp работает полностью на вашей машине — ретрансляционного сервера нет

• Стартовая проверка аутентификации валидирует ваш cookie, не выводя его значение

• Чтобы отозвать доступ: выйдите из wanderlog.com (это аннулирует все сессии), затем повторите захват

Вклад в проект

Pull requests приветствуются. Перед отправкой:

npm run build && npm run test

Для изменений в коде транспорта или инструментов также выполните:

npm run test:integration

Отказ от ответственности

wanderlog-mcp — неофициальный сторонний инструмент, не связанный с Wanderlog и не одобренный им. Он работает, вызывая частный API веб-клиента Wanderlog, который может меняться без предупреждения. Используйте на свой страх и риск.

Лицензия

MIT — см. LICENSE

Создано shaikhspeare