wanderlog-mcp

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

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

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

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

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

Что нового в 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). Инструменты разработчика обходят это ограничение — поэтому там это работает, а в консоли нет.

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

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

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

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

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

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

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

Обновление файла cookie

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

Wanderlog session invalid or expired — Получите свежий cookie connect.sid из инструментов разработчика wanderlog.com и обновите WANDERLOG_COOKIE в вашей конфигурации MCP.

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

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

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

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

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

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

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

• wanderlog-mcp работает полностью на вашем компьютере — нет никакого промежуточного сервера

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

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

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

Пул-реквесты приветствуются. Перед отправкой:

npm run build && npm run test

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

npm run test:integration

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

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

Лицензия

MIT — см. LICENSE

Создано shaikhspeare