Rain Check

Ein Remote-MCP-Server, der anhand von Live-Vorhersage-, Tageslicht- und Feiertagsdaten beantwortet, ob ein australischer Außendienst-Auftrag an einem Ort an einem Tag für ein bestimmtes Gewerk ausgeführt werden kann.

Live: https://rain-check-mu.vercel.app MCP-Endpunkt: https://rain-check-mu.vercel.app/mcp OpenAPI: https://rain-check-mu.vercel.app/openapi.json Health: https://rain-check-mu.vercel.app/health

Verbinden

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

Jeder MCP-Client, der Streamable HTTP spricht, kann dieselbe URL verwenden. Es ist ausschließlich POST: Der Server ist zustandslos, daher antworten GET und DELETE absichtlich mit 405.

Für alles, was kein MCP spricht, befinden sich die identischen Operationen unter /v1/<operation> und werden durch /openapi.json beschrieben, das aus denselben Konstanten erzeugt wird, die auch die MCP-Tools verwenden, sodass die beiden nicht auseinanderdriften können.

Related MCP server: au-weather-mcp

Lokal ausführen

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

Es gibt nirgendwo Mocks. Der Sinn dieser Tests ist es, eine Änderung der Form einer vorgelagerten Quelle zu erkennen, und ein Mock wird das nie.

npm run adversarial ist der Test, der Dinge findet. Er wirft unsinnige Bereiche, feindliche Zeichenketten, falsche Typen, fremde Koordinaten und fehlerhafte Protokollrahmen auf den bereitgestellten Server; eine Ablehnung mit einer brauchbaren Meldung besteht, ein 500 oder eine selbstsichere Antwort auf eine Frage, die es nicht beantworten sollte, schlägt fehl. Er fand drei echte Fehler, die die Happy-Path-Suiten übersehen hatten.

Überprüfen, ohne diesem Repository zu vertrauen

npm run prove existiert, weil meine eigenen Tests, die bestehen, jemandem, der sie nicht geschrieben hat, sehr wenig beweisen. Es verbindet sich mit dem offiziellen MCP-Client-SDK, nimmt dann jede Zahl, die der Server gemeldet hat, und ruft denselben Tag direkt von Open-Meteo erneut ab, vergleicht Feld für Feld und gibt die verwendete Upstream-URL aus, damit du sie selbst öffnen kannst.

Drei weitere Wege, die nichts von hier benötigen:

# 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

Und die Version, die nur einen Browser benötigt: Öffne beide und vergleiche die Daten. rain_mm im ersten entspricht precipitation_sum im zweiten.

• 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

Bereitstellen

vercel deploy --prod

Wie es aufgebaut ist

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

Beide Eingangstüren importieren src/core.ts. Das ist der einzige Weg, wie dem benutzerdefinierten GPT und dem MCP-Client vertraut werden kann, dieselbe Antwort zu geben, und es bedeutet, dass ein einmal festgelegter Schwellenwert überall festgelegt ist.

Was es nicht tun wird

• Einen Schwellenwert als Sicherheitsfreigabe darstellen. Sie sind Planungsstandards, die in jeder Antwort angezeigt und pro Aufruf überschrieben werden können.

• Über die Sechzehn-Tage-Vorhersage hinaus raten. Spätere Daten kommen in out_of_range mit dem Grund und ohne Daten zurück.

• Daten von Drittanbietern zu Feiertagen als maßgeblich durchgehen lassen. Es ist nur auf Bundesstaatsebene, enthält keine regionalen oder Ausstellungstage, und jede Antwort verlinkt die offizielle Seite der Landesregierung.

• Eine Lücke mit einer Vermutung füllen. Wenn eine vorgelagerte Quelle nicht erreichbar ist, sagt das Tool, welche Quelle und was zu tun ist, und weist das Modell an, keine Meinung zu ersetzen.

• Zwischen zwei Richmonds wählen. Mehrdeutigkeit kommt als Kandidaten zurück.

Datenquellen

• Wetter und Geokodierung: Open-Meteo, CC BY 4.0.

• Feiertage: Nager.Date, Drittanbieter, nur auf Bundesstaatsebene.

Die API des Bureau of Meteorology wird nicht verwendet: Ihre eigenen Bedingungen sagen „Du darfst es nicht verwenden, kopieren oder teilen".