Outsite Availability MCP

공식이 아닌 읽기 전용 MCP 서버로, 공개된 Outsite 위치, 표시된 숙박 요금, 개별 객실 캘린더를 조사하기 위한 도구입니다.

저장소: kristianeboe/outsite-mcp

이 프로젝트는 Outsite의 공개 웹사이트와 예약 인터페이스에서 사용하는 동일한 익명 GraphQL 읽기 요청을 사용합니다. 브라우저 쿠키를 전달하지 않으며, 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 세션 쿠키나 계정 토큰을 수락, 저장 또는 전달하지 않습니다.

• 예약, 결제, 예약 변경 또는 기타 변형 작업을 추가하지 않습니다.

• 반환된 멤버 요금 라벨은 공개 가격 탐색으로 취급하며, 멤버십 자격의 증거로 취급하지 않습니다.

• 원시 요금 합계와 타임스탬프를 보존합니다. 가용성을 약속하지 않습니다.

참고 문서

• OpenAI: MCP 서버 구축

• OpenAI: 도구 정의

• Manufact TypeScript 퀵스타트

라이선스

MIT