Outsite Availability MCP

Неофициальный MCP-сервер только для чтения, предназначенный для исследования публичных локаций Outsite, указанных цен на проживание и календарей отдельных номеров.

Репозиторий: kristianeboe/outsite-mcp

Этот проект использует публичный веб-сайт Outsite и те же анонимные GraphQL-запросы, которые применяются в его интерфейсе бронирования. Он не передаёт файлы cookie браузера, не получает доступ к аккаунтам Outsite, не бронирует номера и не осуществляет платежи. Outsite не поддерживает этот проект, и его частный GraphQL-контракт может меняться без предупреждения.

Инструменты

• find_outsite_locations: сопоставляет город, страну, район или название дома с идентификатором Outsite (slug).

• search_outsite_stays: возвращает текущие комбинации номеров и тарифов для конкретных дат.

• get_outsite_room_calendar: позволяет просмотреть конкретный тип номера в более широком диапазоне дат и выявить непрерывные периоды доступности.

Все инструменты доступны только для чтения и включают исходный URL и временную метку fetchedAt.

Локальная разработка

Требуется Node.js 22.22.2 или новее и pnpm.

pnpm install --ignore-workspace
pnpm dev

Конечная точка MCP доступна по адресу http://localhost:3000/mcp. Инспектор фреймворка доступен с локального сервера разработки.

Проверки

pnpm typecheck
pnpm test
RUN_LIVE=1 pnpm test
pnpm build

Живой тест отправляет анонимные запросы к Outsite и подтверждает обнаружение локаций, поиск тарифов и календарь номеров.

Конфигурация

Настройки по умолчанию подходят для развёртывания. Дополнительные переменные окружения:

• OUTSITE_GRAPHQL_URL: по умолчанию https://api.outsite.co/graphql.

• OUTSITE_CACHE_TTL_MS: длительность кэширования анонимных данных от вышестоящего сервиса, по умолчанию 300000.

• OUTSITE_TIMEOUT_MS: тайм-аут запроса к вышестоящему сервису, по умолчанию 12000.

Развёртывание

Manufact Cloud является каноническим хостом. Предполагаемая публичная конечная точка:

https://outsite-mcp.kristianeboe.me/mcp

Разверните из подключённого репозитория GitHub или выполните pnpm deploy. После каждого изменения контракта инструментов повторно запускайте живой смоук-тест и MCP Inspector против производственной конечной точки.

Границы

• Сохраняйте публичный интерфейс анонимным и доступным только для чтения.

• Никогда не принимайте, не храните и не передавайте файлы cookie сеанса Outsite или токены аккаунта.

• Не добавляйте бронирование, платежи, изменения резервирования или другие мутации.

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

• Сохраняйте исходные суммы тарифов и временные метки. Не обещайте доступность.

Использованная документация

• OpenAI: Создание MCP-сервера

• OpenAI: Определение инструментов

• Manufact TypeScript: краткое руководство

Лицензия

MIT