@jablum/weather-mcp 1.7.0

package/dist/utils/validation.js

@@ -0,0 +1,177 @@
+/**
+ * Input validation utilities for API parameters
+ * Provides runtime type checking and sanitization
+ */
+import { FormatConstants } from '../config/displayThresholds.js';
+/**
+ * Validate that latitude is a valid number within range
+ * @param lat - Latitude value to validate
+ * @throws {Error} If latitude is invalid
+ */
+export function validateLatitude(lat) {
+    if (typeof lat !== 'number' || !Number.isFinite(lat)) {
+        throw new Error(`Invalid latitude: must be a finite number, received ${typeof lat}`);
+    }
+    if (lat < -90 || lat > 90) {
+        throw new Error(`Invalid latitude: ${lat}. Must be between -90 and 90.`);
+    }
+}
+/**
+ * Validate that longitude is a valid number within range
+ * @param lon - Longitude value to validate
+ * @throws {Error} If longitude is invalid
+ */
+export function validateLongitude(lon) {
+    if (typeof lon !== 'number' || !Number.isFinite(lon)) {
+        throw new Error(`Invalid longitude: must be a finite number, received ${typeof lon}`);
+    }
+    if (lon < -180 || lon > 180) {
+        throw new Error(`Invalid longitude: ${lon}. Must be between -180 and 180.`);
+    }
+}
+/**
+ * Validate coordinate pair
+ * @param args - Arguments object potentially containing coordinates
+ * @returns Validated coordinates
+ * @throws {Error} If coordinates are invalid
+ */
+export function validateCoordinates(args) {
+    if (typeof args !== 'object' || args === null) {
+        throw new Error('Invalid arguments: expected object with latitude and longitude');
+    }
+    const { latitude, longitude } = args;
+    validateLatitude(latitude);
+    validateLongitude(longitude);
+    return { latitude, longitude };
+}
+/**
+ * Validate a positive integer within optional range
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @param min - Minimum allowed value (inclusive)
+ * @param max - Maximum allowed value (inclusive)
+ * @returns Validated number
+ * @throws {Error} If value is invalid
+ */
+export function validatePositiveInteger(value, name, min = 1, max = Number.MAX_SAFE_INTEGER) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`Invalid ${name}: must be a finite number, received ${typeof value}`);
+    }
+    if (!Number.isInteger(value)) {
+        throw new Error(`Invalid ${name}: must be an integer, received ${value}`);
+    }
+    if (value < min || value > max) {
+        throw new Error(`Invalid ${name}: ${value}. Must be between ${min} and ${max}.`);
+    }
+    return value;
+}
+/**
+ * Validate a boolean value
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @returns Validated boolean
+ * @throws {Error} If value is invalid
+ */
+export function validateBoolean(value, name) {
+    if (typeof value !== 'boolean') {
+        throw new Error(`Invalid ${name}: must be a boolean, received ${typeof value}`);
+    }
+    return value;
+}
+/**
+ * Validate a date string in ISO format
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @returns Validated date string
+ * @throws {Error} If value is invalid
+ */
+export function validateDateString(value, name) {
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid ${name}: must be a string, received ${typeof value}`);
+    }
+    // Check if it's a valid date format (YYYY-MM-DD or ISO 8601)
+    const date = new Date(value);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid ${name}: "${value}" is not a valid date format`);
+    }
+    return value;
+}
+/**
+ * Validate forecast days parameter
+ * @param args - Arguments object potentially containing days parameter
+ * @returns Validated days value (defaults to 7 if not provided)
+ * @throws {Error} If days parameter is invalid
+ */
+export function validateForecastDays(args) {
+    if (typeof args !== 'object' || args === null) {
+        return FormatConstants.defaultForecastDays;
+    }
+    const { days } = args;
+    if (days === undefined) {
+        return FormatConstants.defaultForecastDays;
+    }
+    return validatePositiveInteger(days, 'days', 1, FormatConstants.maxForecastDays);
+}
+/**
+ * Validate granularity parameter
+ * @param value - Value to validate
+ * @returns Validated granularity ('daily' or 'hourly')
+ * @throws {Error} If value is invalid
+ */
+export function validateGranularity(value) {
+    if (value === undefined) {
+        return 'daily'; // default
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid granularity: must be a string, received ${typeof value}`);
+    }
+    if (value !== 'daily' && value !== 'hourly') {
+        throw new Error(`Invalid granularity: "${value}". Must be either "daily" or "hourly".`);
+    }
+    return value;
+}
+/**
+ * Validate optional boolean with default
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @param defaultValue - Default value if undefined
+ * @returns Validated boolean
+ * @throws {Error} If value is invalid
+ */
+export function validateOptionalBoolean(value, name, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return validateBoolean(value, name);
+}
+/**
+ * Validate historical weather parameters
+ * @param args - Arguments object
+ * @returns Validated parameters
+ * @throws {Error} If parameters are invalid
+ */
+export function validateHistoricalWeatherParams(args) {
+    if (typeof args !== 'object' || args === null) {
+        throw new Error('Invalid arguments: expected object with coordinates and date range');
+    }
+    const { latitude, longitude, start_date, end_date, limit } = args;
+    validateLatitude(latitude);
+    validateLongitude(longitude);
+    const validatedStartDate = validateDateString(start_date, 'start_date');
+    const validatedEndDate = validateDateString(end_date, 'end_date');
+    // Ensure start_date is before end_date
+    if (new Date(validatedStartDate) > new Date(validatedEndDate)) {
+        throw new Error('Invalid date range: start_date must be before or equal to end_date');
+    }
+    const result = {
+        latitude,
+        longitude,
+        start_date: validatedStartDate,
+        end_date: validatedEndDate,
+    };
+    if (limit !== undefined) {
+        result.limit = validatePositiveInteger(limit, 'limit', 1, FormatConstants.maxHistoricalLimit);
+    }
+    return result;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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"}

package/dist/utils/version.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Version utility - Single source of truth for application version
+ *
+ * Reads version from package.json to ensure consistency across all services
+ */
+/**
+ * Application version from package.json
+ */
+export declare const VERSION: string;
+/**
+ * Get User-Agent string for HTTP requests
+ * @returns User-Agent string in format "weather-mcp/VERSION"
+ */
+export declare function getUserAgent(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,eAAO,MAAM,OAAO,EAA0B,MAAM,CAAC;AAErD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/utils/version.js

@@ -0,0 +1,24 @@
+/**
+ * Version utility - Single source of truth for application version
+ *
+ * Reads version from package.json to ensure consistency across all services
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Read version from package.json once at module load time
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+/**
+ * Application version from package.json
+ */
+export const VERSION = packageJson.version;
+/**
+ * Get User-Agent string for HTTP requests
+ * @returns User-Agent string in format "weather-mcp/VERSION"
+ */
+export function getUserAgent() {
+    return `weather-mcp/${VERSION}`;
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,0DAA0D;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAC7D,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAiB,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,OAAO,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@jablum/weather-mcp",
+  "version": "1.7.0",
+  "description": "MCP (Model Context Protocol) server providing weather data from NOAA and Open-Meteo APIs. Supports forecasts, current conditions, and historical weather data (1940-present) with no API keys required.",
+  "mcpName": "io.github.jablum/weather-mcp",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "weather-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "audit": "npm audit --audit-level=moderate",
+    "audit:fix": "npm audit fix"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "weather",
+    "weather-api",
+    "noaa",
+    "open-meteo",
+    "forecast",
+    "climate",
+    "historical-weather",
+    "claude",
+    "claude-code",
+    "ai",
+    "llm"
+  ],
+  "author": "Dan Gahagan",
+  "license": "MIT",
+  "homepage": "https://github.com/jablum/weather-mcp/weather-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jablum/weather-mcp/weather-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/weather-mcp/weather-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.21.1",
+    "axios": "^1.13.1",
+    "dotenv": "^17.2.3",
+    "luxon": "^3.7.2",
+    "mqtt": "^5.14.1",
+    "ngeohash": "^0.6.3"
+  },
+  "devDependencies": {
+    "@types/luxon": "^3.7.1",
+    "@types/ngeohash": "^0.6.8",
+    "@types/node": "^24.10.0",
+    "@vitest/coverage-v8": "^4.0.8",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.8"
+  }
+}