Outsite Availability MCP

Ein inoffizieller, schreibgeschützter MCP-Server zur Recherche öffentlicher Outsite-Standorte, angebotener Aufenthaltsraten und individueller Zimmerkalender.

Repository: kristianeboe/outsite-mcp

Dieses Projekt nutzt die öffentliche Website von Outsite und dieselben anonymen GraphQL-Reads, die auch die Buchungsoberfläche verwendet. Es leitet keine Browser-Cookies weiter, greift nicht auf Outsite-Konten zu, bucht keine Zimmer und führt keine Zahlungen durch. Outsite hat dieses Projekt nicht unterstützt, und der private GraphQL-Vertrag kann sich ohne Vorankündigung ändern.

Tools

• find_outsite_locations: Löst eine Stadt, ein Land, eine Nachbarschaft oder einen Hausnamen in einen Outsite-Slug auf.

• search_outsite_stays: Gibt aktuelle Zimmer-/Ratenkombinationen für exakte Daten zurück.

• get_outsite_room_calendar: Untersucht einen bestimmten Zimmertyp über einen größeren Datumsbereich und identifiziert zusammenhängende freie Zeiträume.

Alle Tools sind schreibgeschützt und enthalten eine Quell-URL sowie einen fetchedAt-Zeitstempel.

Lokale Entwicklung

Erfordert Node.js 22.22.2 oder neuer und pnpm.

pnpm install --ignore-workspace
pnpm dev

Der MCP-Endpunkt ist unter http://localhost:3000/mcp verfügbar. Der Inspector des Frameworks ist über den lokalen Entwicklungsserver erreichbar.

Checks

pnpm typecheck
pnpm test
RUN_LIVE=1 pnpm test
pnpm build

Der Live-Test sendet anonyme Anfragen an Outsite und bestätigt Standortermittlung, Ratensuche und einen Zimmerkalender.

Konfiguration

Die Standardwerte sind für die Bereitstellung geeignet. Optionale Umgebungsvariablen:

• OUTSITE_GRAPHQL_URL: Standardmäßig https://api.outsite.co/graphql.

• OUTSITE_CACHE_TTL_MS: Dauer des anonymen Upstream-Caches, Standard 300000.

• OUTSITE_TIMEOUT_MS: Timeout für Upstream-Anfragen, Standard 12000.

Bereitstellung

Manufact Cloud ist der kanonische Host. Der vorgesehene öffentliche Endpunkt ist:

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

Bereitstellung über das verbundene GitHub-Repository oder mit pnpm deploy. Führen Sie nach jeder Änderung am Tool-Vertrag den Live-Smoke-Test und den MCP Inspector erneut gegen den Produktionsendpunkt aus.

Grenzen

• Halten Sie die öffentliche Oberfläche anonym und schreibgeschützt.

• Akzeptieren, speichern oder leiten Sie niemals Outsite-Sitzungscookies oder Kontotokens weiter.

• Fügen Sie keine Buchungs-, Zahlungs-, Reservierungsänderungen oder andere Mutationen hinzu.

• Behandeln Sie zurückgegebene Mitgliedsraten-Labels als öffentliche Preisfindung, nicht als Nachweis eines Mitgliedschaftsanspruchs.

• Bewahren Sie rohe Ratensummen und Zeitstempel auf. Versprechen Sie keine Verfügbarkeit.

Verwendete Dokumentation

• OpenAI: Build an MCP server

• OpenAI: Define tools

• Manufact TypeScript quickstart

Lizenz

MIT