Traveler.md MCP-сервер

Traveler.md предоставляет AI-ассистенту сведения о путешествиях, которые пользователь сохраняет о себе. Сервис хранит долгосрочный профиль с предпочтениями путешественника и отдельный план для каждой поездки. Данные принадлежат путешественнику: он один раз разрешает доступ и может отозвать его в любой момент.

В этом репозитории описан размещённый MCP-сервер (Model Context Protocol), доступный по адресу https://mcp.traveler.md/mcp. Исходный код сервера здесь не публикуется. Полная документация доступна по адресу https://docs.traveler.md/mcp.

Возможности сервера

Сервер хранит документы двух типов и возвращает их по запросу.

traveler.md — профиль путешественника. В нём указаны постоянные предпочтения: выбор места в самолёте, стиль отелей, бюджет, особенности питания и попутчики. У каждого путешественника один профиль.
trip.md — сведения об одной поездке: направления, даты, маршрут, бронирования и заметки. У путешественника может быть несколько таких документов.

Ассистент читает эти документы перед планированием или рекомендациями, чтобы путешественнику не приходилось повторять информацию. Ассистент также сохраняет новые сведения, поэтому в следующем разговоре они уже будут ему доступны.

Область применения: только сведения о путешествиях. Сервер не располагает данными о наличии мест и услуг, ценах и доступности, а также не предлагает рекомендации. Рекомендации формирует ваш ассистент, а профиль помогает ему учитывать ваши предпочтения.

Инструменты

Инструмент	Назначение
`read_profile`	Возвращает профиль, при необходимости ограничивая его указанными разделами
`create_profile`	Создаёт профиль при первом использовании
`update_profile`	Изменяет один или несколько разделов профиля
`list_trips`	Показывает поездки постранично или выполняет поиск по названию, содержимому, статусу или дате
`read_trip`	Возвращает сведения об одной поездке
`create_trip`	Создаёт поездку с названием и статусом
`update_trip`	Изменяет статус, даты или разделы поездки
`archive_trip`	Переносит поездку в архив

Каждый документ состоит из именованных разделов, а каждый раздел — из списка коротких предложений. Для обновления требуется version_hash, полученный при последнем чтении. Благодаря этому изменения, внесённые двумя ассистентами в одну запись, не перезаписывают друг друга незаметно.

Настройка

Сервер использует streamable HTTP и OAuth 2.1. API-ключи и переменные окружения не требуются. При первом подключении клиент открывает окно браузера. Путешественник входит в Traveler.md и подтверждает подключение.

VS Code и GitHub Copilot

Подключение в один клик:

Добавьте этот фрагмент в .vscode/mcp.json рабочей области или в пользовательский файл mcp.json:

{
  "servers": {
    "travelermd": {
      "type": "http",
      "url": "https://mcp.traveler.md/mcp"
    }
  }
}

Другие клиенты

claude mcp add --transport http travelermd https://mcp.traveler.md/mcp   # Claude Code
codex mcp add travelermd --url https://mcp.traveler.md/mcp               # Codex

Любой клиент, поддерживающий удалённый MCP, может подключиться напрямую по URL:

{
  "mcpServers": {
    "travelermd": {
      "url": "https://mcp.traveler.md/mcp"
    }
  }
}

Инструкции по настройке Claude, Cursor, ChatGPT, Gemini и других клиентов доступны по адресу https://docs.traveler.md/mcp.

Использование

После подключения задавайте вопросы о путешествиях обычным языком. Ассистент вызовет нужные инструменты.

Вы говорите	Ассистент вызывает
"Где нам остановиться в Лиссабоне?"	`read_profile`, затем даёт рекомендации
"Какая у меня следующая поездка?"	`list_trips` с сортировкой по дате начала
"Какой план поездки в Киото?"	`list_trips`, затем `read_trip`
"Я всегда хочу сидеть у прохода"	`update_profile`
"Мы забронировали рёкан"	`update_trip`
"Когда-нибудь я хотел бы увидеть Патагонию"	`create_trip` со статусом Dreaming

Ассистенты часто отвечают на вопросы о путешествиях, опираясь только на текущий разговор, и не читают профиль. Добавьте постоянную инструкцию в файл инструкций ассистента, чтобы он сначала обращался к профилю:

Прежде чем давать рекомендации, планировать, составлять короткий список вариантов или бронировать что-либо, связанное с путешествиями, вызови read_profile на сервере travelermd. Если речь идёт о конкретной поездке, найди её с помощью list_trips и открой с помощью read_trip.

Навыки и плагин для агента

Плагин для агента, который объединяет этот сервер с навыками для первоначальной настройки, обсуждения поездок, организации путешествий и анализа впечатлений после поездки, доступен по адресу https://github.com/TravelAiSolution/traveler-md-agent-plugin. Навыки помогают ассистенту освоить названия разделов, ограничения на количество предложений и последовательность действий: сначала чтение, затем запись.

Данные и конфиденциальность

Все записи принадлежат путешественнику. Доступ предоставляется для каждого клиента отдельно через OAuth и отзывается на странице учётной записи Traveler.md. Сервер отклоняет медицинские сведения в любых разделах, включая информацию об аллергиях и ограничениях в питании, если она указана как медицинская. Политика конфиденциальности доступна по адресу https://traveler.md/privacy.

Поддержка

Если у вас есть вопросы о сервере или его инструментах, создайте issue в этом репозитории. По вопросам учётной записи или безопасности пишите на support@traveler.md.

Лицензия

На README и файлы в этом репозитории распространяется лицензия MIT. Размещённый сервер — сервис Traveler.md. Traveler.md и TravelAI являются товарными знаками TravelAI; эта лицензия не предоставляет права на их использование.