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。框架的 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：构建 MCP 服务器

• OpenAI：定义工具

• Manufact TypeScript 快速入门

许可证

MIT