HM

hideya/mcp-server-weather-js

Productivity workflow
14 stars 9 forks Quality 52 Trend 20MIT

Simple Weather MCP Server Example

Overview

Node.js server implementing Model Context Protocol (MCP) for accessing weather information in the US. This is an example explained in MCP Quickstart. It has been hosted as an npm package for convenient use with npx. Merge the following JSON fragment into your claude_desktop_config.json. Please refer to the "Testing your server with Claude for Desktop" section of MCP Quickstart for details. - - Get weather alerts for a US state. - Input: state (string): Two-letter US state code (e.g. CA, NY) - - Get weather forecast for a location in the US - Inputs: - latitude (number): Latitude of the location - longitude (number): Longitude of the location - Tomorrow's weather in Palo Alto? - Any weather alerts in California? This example is based on the code explained in MCP Quickstart (github), whose license is CC-BY-4.0. The completed code examples are also hosted in this repo, whose license is MIT (Copyright (c) 2025 Model Context Protocol). So I've chosen the MIT license for this repo.

README

Simple Weather MCP Server example from Quickstart

Node.js server implementing Model Context Protocol (MCP) for accessing weather information in the US.

This is an example explained in MCP Quickstart.

It has been hosted as an npm package for convenient use with npx.

Usage with Claude Desktop

Merge the following JSON fragment into your claude_desktop_config.json. Please refer to the “Testing your server with Claude for Desktop” section of MCP Quickstart for details.

# MacOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code $env:AppData\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "weather": {
      "command": "npx",
        "args": [
            "-y",
            "@h1deya/mcp-server-weather"
        ],
    }
  }
}

Tools

  • get-alerts
    • Get weather alerts for a US state.
    • Input: state (string): Two-letter US state code (e.g. CA, NY)
  • get-forecast
    • Get weather forecast for a location in the US
    • Inputs:
      • latitude (number): Latitude of the location
      • longitude (number): Longitude of the location

Example Queries

  • Tomorrow’s weather in Palo Alto?
  • Any weather alerts in California?

Original Author and License

This example is based on the code explained in MCP Quickstart (github), whose license is CC-BY-4.0. The completed code examples are also hosted in this repo, whose license is MIT (Copyright © 2025 Model Context Protocol). So I’ve chosen the MIT license for this repo.

View the full README on GitHub

Install

npx -y @h1deya/mcp-server-weather
New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "weather": { "command": "npx", "args": [ "-y", "@h1deya/mcp-server-weather" ], } } }