@mrfentmen/nws-weather-mcp 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# NWS Weather MCP
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Seven day forecasts for US locations from the National Weather Service. Keyless — no signup, no API key, no environment variables.
+
+## Install
+
+```bash
+npx -y @mrfentmen/nws-weather-mcp
+```
+
+Or add it to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "nws-weather-mcp": { "command": "npx", "args": ["-y", "@mrfentmen/nws-weather-mcp"] }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `forecast` | Daily forecast for a latitude and longitude |
+
+## Notes
+
+The National Weather Service covers the United States and its territories. Coordinates are decimal degrees; the first call resolves the local forecast office.
+
+## Licence
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,3 @@
+export declare class NwsWeatherError extends Error {
+}
+export declare function forecast(latitude?: number, longitude?: number, periods?: number): Promise<string>;

package/dist/api.js

@@ -0,0 +1,62 @@
+/**
+ * NWS Weather — Seven day forecasts for US locations from the National Weather Service. Keyless: no signup, no API key, no environment variables.
+ *
+ * Verified live against api.weather.gov.
+ */
+const API = "https://api.weather.gov";
+export class NwsWeatherError extends Error {
+}
+const val = (v) => {
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number")
+        return Number.isFinite(v) ? String(v) : "";
+    if (Array.isArray(v))
+        return v.length > 0 ? val(v[0]) : "";
+    if (v && typeof v === "object") {
+        const o = v;
+        if ("en" in o)
+            return val(o.en);
+        const first = Object.values(o)[0];
+        return first === undefined ? "" : val(first);
+    }
+    return "";
+};
+const at = (o, path) => path === "" ? o : path.split(".").reduce((acc, k) => (acc && typeof acc === "object" ? acc[k] : undefined), o);
+const rows = (v) => (Array.isArray(v) ? v : []);
+async function get(url, init, timeoutMs = 25000) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            ...init,
+            signal: ctrl.signal,
+            headers: { "user-agent": "nws-weather-mcp", accept: "application/json", ...(init?.headers ?? {}) },
+        });
+        if (!res.ok)
+            throw new NwsWeatherError(`NWS Weather returned HTTP ${res.status}`);
+        return (await res.json());
+    }
+    catch (e) {
+        if (e instanceof NwsWeatherError)
+            throw e;
+        if (e.name === "AbortError")
+            throw new NwsWeatherError("NWS Weather request timed out");
+        throw new NwsWeatherError(`NWS Weather request failed: ${e.message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function forecast(latitude = 39.7456, longitude = -97.0892, periods = 5) {
+    const point = await get(`${API}/points/${latitude},${longitude}`);
+    const url = val(at(point, "properties.forecast"));
+    if (url === "")
+        throw new NwsWeatherError(`no forecast office for ${latitude},${longitude}`);
+    const body = await get(url);
+    const items = rows(at(body, "properties.periods")).slice(0, Math.max(1, periods));
+    if (items.length === 0)
+        throw new NwsWeatherError("forecast returned no periods");
+    const lines = items.map((r, i) => `${i + 1}. ${val(at(r, "name"))}: ${val(at(r, "temperature"))} ${val(at(r, "temperatureUnit"))} — ${val(at(r, "shortForecast"))}`);
+    return [`NWS forecast for ${latitude},${longitude}`, "", ...lines].join("\n");
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("nws-weather-mcp running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,18 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { forecast } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const fail = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const errorMessage = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+export function createServer() {
+    const server = new McpServer({ name: "nws-weather-mcp", version: "1.0.0" });
+    server.tool("forecast", "Daily forecast for a latitude and longitude", { latitude: z.number().min(-90).max(90).describe("Latitude, e.g. 39.7456"), longitude: z.number().min(-180).max(180).describe("Longitude, e.g. -97.0892"), periods: z.number().int().min(1).max(14).default(5).describe("How many periods") }, async ({ latitude, longitude, periods }) => {
+        try {
+            return text(await forecast(latitude, longitude, periods));
+        }
+        catch (e) {
+            return fail(errorMessage(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@mrfentmen/nws-weather-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "NWS Weather: US forecasts from api.weather.gov, no key or signup - keyless.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/nws-weather-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrfentmen/awesome-servers.git"
+  },
+  "bin": {
+    "nws-weather-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "test": "node tests/smoke.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "nws-weather",
+    "weather",
+    "forecast",
+    "usa",
+    "noaa",
+    "keyless"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}