Skip to main content
Glama
deenesjakoruzh
Kaushik2105

mcp-weather

by Kaushik2105
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

🌤️ Kaushik's Weather MCP Server

TypeScript Model Context Protocol Node.js Tests Claude Verified License: ISC

A production-ready Model Context Protocol (MCP) server built in TypeScript, connecting LLMs (such as Claude Desktop, Cursor, and custom AI agents) to real-time National Weather Service (NWS / NOAA) meteorological data.

🔗 Live Proof of Integration

🚀 Verified Working with Claude Desktop: Check out the live chat session demonstrating real-time forecast retrieval, alerts, and health diagnostics:
👉 View Live Claude AI Chat Proof

Related MCP server: mcp-weather

✨ Architectural Highlights

  • 🏗️ Modular Clean Architecture: Decoupled into dedicated service layers (CacheService, RateLimiterService, NwsClient, Logger, Formatter).

  • 📡 Official Meteorological Bulletins: Structured weather reports with standardized metadata and provider attribution.

  • ⚡ In-Memory Caching (5-Min TTL): Thread-safe in-memory cache reducing upstream API traffic by up to 80%.

  • 🛡️ Zero-Vibe Security Layer: Strict input sanitization, XSS entity escaping, and client-isolated rate limiting (100 req/min).

  • 🔁 Resilience & Fault Tolerance: Automated exponential backoff retries for HTTP 5xx / 429 errors and request timeout guards.

  • 🩺 Observability & Diagnostics: Built-in health_check, get_metrics, and clear_cache tools with structured JSON logging.

📁 Project Structure

weather/
├── src/
│   ├── config/          # Central configuration & runtime constants
│   ├── services/        # Core business logic (Cache, RateLimiter, NwsClient, Formatter, Logger)
│   ├── tools/           # MCP Tool handlers (alerts, forecast, diagnostics)
│   ├── types/           # Strongly typed TypeScript interfaces
│   ├── utils/           # Input sanitization and security helpers
│   └── index.ts         # Server bootstrap, transport initialization & graceful shutdown
├── tests/
│   ├── unit/            # Unit test suites (utils, sanitizer, cache)
│   ├── integration/     # Upstream NWS API integration & retry tests
│   ├── performance/     # Cache throughput & rate-limiting load tests
│   ├── security/        # XSS, injection prevention & boundary tests
│   └── basic.test.ts    # Comprehensive test runner
├── build/               # Compiled ES module JavaScript distribution
├── package.json
└── tsconfig.json

🛠️ MCP Tools

Tool

Parameters

Description

get_forecast

latitude (number), longitude (number)

Retrieves real-time period forecasts (temperatures, winds, conditions) for US coordinates.

get_alerts

state (2-letter US code, e.g. CA, NY, TX)

Fetches active severe weather alerts, warnings, and meteorological advisories.

health_check

None

Returns runtime health, uptime, heap memory usage, cache size, and API connection status.

get_metrics

None

Outputs performance diagnostics and active rate-limit client buckets.

clear_cache

None

Flushes the in-memory cache and returns the number of purged entries.

🚀 Getting Started

1. Clone & Install

git clone https://github.com/Kaushik2105/mcp-weather.git
cd mcp-weather
npm install

2. Build

npm run build

3. Run Test Suite

npm test

🔌 Connecting to Claude Desktop

Add this configuration to your Claude Desktop configuration file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kaushik-weather": {
      "command": "node",
      "args": [
        "c:/Workholic/LawSikho/POCs/weather/weather/build/index.js"
      ]
    }
  }
}

Note: Restart Claude Desktop after saving the configuration.

💬 Sample Prompts for Claude

  • "Show me the official forecast bulletin from Kaushik's weather tool for Los Angeles (Lat: 34.0522, Lon: -118.2437)"

  • "Are there any active weather alerts for Florida (FL)?"

  • "Run a health check diagnostic on Kaushik's weather MCP server."

👨‍💻 Author

Kaushik Karmakar

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Weather MCP Server

    aitiwari
    F
    license
    B
    quality
    D
    maintenance
    Provides real-time US weather alerts and forecasts by integrating with the National Weather Service API. It enables AI assistants to fetch state-specific alerts and detailed local forecasts using geographic coordinates.
    2
    1
    -

  • mcp-weather

    jpan8866
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time weather alerts and forecasts from the National Weather Service for US locations, integrating with AI assistants via the Model Control Protocol.
    -

  • Weather MCP Server

    Clement-Okolo
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time weather alerts and forecasts for US locations by integrating with the National Weather Service API. Supports both server and client interactions with optional LLM summarization.
    -

  • mcp-weather-api

    devgrunge
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides weather forecasts and alerts for US locations via the National Weather Service API, enabling AI assistants to deliver real-time weather information.
    8 npm
    -