home / mcp / mcp weather server

MCP Weather Server

An MCP server to get Weather details

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "adarshem-mcp-server-learn": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js"
      ]
    }
  }
}

You can run a lightweight MCP server that exposes weather tools to fetch active alerts and forecasts. This server is built with Node.js and serves two MCP tools you can call from an MCP client: get-alerts and get-forecast. It’s useful for adding weather capabilities to your workflows and chat assistants.

How to use

You will connect to the weather MCP server from your MCP client and invoke the available tools to retrieve weather information. The two tools are get-alerts, which returns active weather alerts for a US state, and get-forecast, which provides a forecast for a specific location based on latitude and longitude. Use these tools within your MCP client to build automation, alerts, or planning features without leaving your workflow.

How to install

Prerequisites you need before installation are installed Node.js and familiarity with MCP concepts and tools.

Concrete installation steps fall into two paths. Choose the path that matches how you want to run the server.

# 1) Installing via Smithery (automatic client install)

npx -y @smithery/cli install @adarshem/mcp-server-learn --client claude

# 2) Manual installation

# 2.1 Clone the repository
git clone <repository-url>
cd weather

# 2.2 Install dependencies
pnpm install

# 2.3 Build the project
pnpm build

Configuration and startup

After building, you configure how the server runs in your development environment. The following example shows how to point your MCP client to the local built index file.

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js"
      ]
    }
  }
}

Notes on setup and environment

When you run the server locally, you will use the built index file as the entry point for the Node runtime. The server does not require any additional environment variables in the provided example, but you may choose to set local environment values for readability or debugging in your development setup.

Troubleshooting and tips

If you encounter issues starting the server, verify that the build step completed successfully and that the path to the built index.js is correct. Ensure Node.js is installed and that you can run Node from your command line. If you need to re-run the build, execute the same pnpm commands used during installation.

Available tools

get-alerts

Fetches active weather alerts for a given US state, enabling you to monitor weather hazards and stay informed for planning or safety decisions.

get-forecast

Provides a weather forecast for a specific location using latitude and longitude to support planning, travel, or automation workflows.