Outsite Availability MCP

公開されているOutsiteの拠点、提示された宿泊料金、個別の部屋カレンダーを調査するための、非公式の読み取り専用MCPサーバーです。

リポジトリ: kristianeboe/outsite-mcp

このプロジェクトは、Outsiteの公開ウェブサイトと、その予約インターフェースが使用するのと同じ匿名GraphQL読み取りを使用しています。ブラウザのCookieを転送したり、Outsiteアカウントにアクセスしたり、部屋を予約したり、支払いを行ったりすることはありません。Outsiteはこのプロジェクトを承認しておらず、その非公開のGraphQL契約は予告なく変更される可能性があります。

ツール

• find_outsite_locations: 都市、国、地域、またはハウス名をOutsiteのスラッグに解決します。

• 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で利用できます。フレームワークのInspectorはローカル開発サーバーから利用できます。

チェック

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を再実行してください。

境界

• 公開面を匿名かつ読み取り専用に保ちます。

• OutsiteのセッションCookieやアカウントトークンを受け入れ、保存、転送することは決してありません。

• 予約、支払い、予約変更、その他の変更操作を追加しないでください。

• 返されたメンバー料金ラベルは、メンバーシップ資格の証明ではなく、公開価格の調査として扱ってください。

• 生の料金合計とタイムスタンプを保持してください。空き状況を保証しないでください。

使用したドキュメント

• OpenAI: Build an MCP server

• OpenAI: Define tools

• Manufact TypeScript quickstart

ライセンス

MIT