Rain Check

호주 현장 서비스 작업을 특정 장소와 날짜, 직종에 대해 수행할 수 있는지 실시간 예보, 일광, 공휴일 데이터를 기반으로 답하는 원격 MCP 서버입니다.

라이브: https://rain-check-mu.vercel.app MCP 엔드포인트: https://rain-check-mu.vercel.app/mcp OpenAPI: https://rain-check-mu.vercel.app/openapi.json 상태 확인: https://rain-check-mu.vercel.app/health

연결하기

claude mcp add --transport http rain-check https://rain-check-mu.vercel.app/mcp

Streamable HTTP를 지원하는 모든 MCP 클라이언트는 동일한 URL을 사용할 수 있습니다. POST 전용입니다. 서버는 상태 비저장(stateless)이므로 GET과 DELETE는 설계상 405를 반환합니다.

MCP를 지원하지 않는 도구의 경우, 동일한 작업이 /v1/<operation>에 있으며 /openapi.json에 설명되어 있습니다. 이 파일은 MCP 도구가 사용하는 것과 동일한 상수에서 생성되므로 둘이 어긋날 수 없습니다.

Related MCP server: au-weather-mcp

로컬에서 실행하기

npm install
npm run typecheck     # tsc, no emit
npm run smoke         # every operation against the real upstreams
npm run smoke:mcp     # every endpoint over a real node:http server
npm run smoke:live -- https://rain-check-mu.vercel.app        # the deployed server
npm run adversarial -- https://rain-check-mu.vercel.app       # tries to break it
npm run prove -- https://rain-check-mu.vercel.app             # independent evidence

어디에도 목(mock)이 없습니다. 목의 목적은 업스트림의 형태 변화를 잡아내는 것인데, 목은 절대 그렇게 하지 않기 때문입니다.

npm run adversarial이 문제를 찾아내는 명령입니다. 배포된 서버에 터무니없는 범위, 적대적인 문자열, 잘못된 타입, 외국 좌표, 잘못된 형식의 프로토콜 프레임을 던집니다. 사용 가능한 메시지와 함께 거절하면 통과이고, 500을 반환하거나 답해서는 안 되는 질문에 자신 있게 답하면 실패입니다. 이 명령은 정상 경로 테스트가 놓친 실제 버그 3개를 찾아냈습니다.

이 저장소를 신뢰하지 않고 검증하기

npm run prove는 제가 작성한 테스트가 통과한다는 것이 테스트를 작성하지 않은 사람에게는 별 의미가 없기 때문에 존재합니다. 공식 MCP 클라이언트 SDK로 연결한 다음, 서버가 보고한 모든 숫자를 가져와 같은 날짜를 Open-Meteo에서 직접 다시 조회하여 필드별로 비교하고, 사용한 업스트림 URL을 출력하므로 직접 열어볼 수 있습니다.

여기에서 아무것도 필요로 하지 않는 세 가지 방법이 더 있습니다:

# Anthropic's own inspector, not my code
npx @modelcontextprotocol/inspector --cli https://rain-check-mu.vercel.app/mcp --transport http --method tools/list

# raw JSON-RPC, no client, no session, because it is stateless
curl -s -X POST https://rain-check-mu.vercel.app/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# let your own client run its health check against it
claude mcp add --transport http rain-check https://rain-check-mu.vercel.app/mcp
claude mcp list

그리고 브라우저만 필요한 버전: 아래 두 링크를 모두 열고 날짜를 비교하세요. 첫 번째의 rain_mm은 두 번째의 precipitation_sum과 같습니다.

• https://rain-check-mu.vercel.app/v1/workability?location=Bendigo&trade=concreting&days=3

• https://api.open-meteo.com/v1/forecast?latitude=-36.75818&longitude=144.28024&daily=precipitation_sum&timezone=Australia/Melbourne

배포

vercel deploy --prod

구조

src/core.ts          the six operations, with no transport in them
src/mcpServer.ts     the MCP tool surface
src/lib/             http, dates, geocoding, forecast, holidays, thresholds, verdicts
api/mcp.ts           Streamable HTTP, stateless
api/v1/[op].ts       the same operations over REST
api/openapi.ts       the OpenAPI document, generated from the same constants
api/health.ts        calls every upstream and reports real latency
public/index.html    the landing page, including the build log
scripts/             the three verification runs

두 진입점 모두 src/core.ts를 가져옵니다. 이것이 커스텀 GPT와 MCP 클라이언트가 동일한 답을 준다고 신뢰할 수 있는 유일한 방법이며, 한 번 수정된 임계값이 모든 곳에 적용된다는 것을 의미합니다.

하지 않는 일

• 임계값을 안전 승인으로 제시하지 않습니다. 이는 계획 기본값이며 모든 답변에 표시되고 호출별로 재정의할 수 있습니다.

• 16일 예보를 넘어 추측하지 않습니다. 이후 날짜는 out_of_range에 이유와 함께 데이터 없이 반환됩니다.

• 제3자 공휴일 데이터를 권위 있는 것으로 취급하지 않습니다. 주(state) 수준만 제공하며 지역 또는 쇼데이(show day)를 포함하지 않고, 모든 응답은 공식 주정부 페이지를 링크합니다.

• 빈틈을 추측으로 채우지 않습니다. 업스트림에 연결할 수 없으면 도구가 어느 업스트림인지와 무엇을 해야 하는지 말하고, 모델에게 의견을 대신 제시하지 말라고 지시합니다.

• 두 리치먼드(Richmond) 중 하나를 선택하지 않습니다. 모호함은 후보로 반환됩니다.

데이터 소스

• 날씨 및 지오코딩: Open-Meteo, CC BY 4.0.

• 공휴일: Nager.Date, 제3자, 주 수준만.

기상청(Bureau of Meteorology) API는 사용되지 않습니다. 자체 약관에 "사용, 복사 또는 공유해서는 안 됩니다"라고 명시되어 있기 때문입니다.