Weather MCP Server

A simple Model Context Protocol (MCP) server that exposes a get_weather tool. It fetches real-time weather for any GPS coordinates using the free Open-Meteo API — no API key required.

Requirements

• Node.js 18 or later. If you use nvm and have multiple Node versions installed, make sure a compatible version resolves first in your PATH, or point your MCP client config at a specific Node binary (see Usage below).

• No API key or environment variables required.

Related MCP server: mcp-poc

Tool

get_weather

Fetches current temperature, feels-like temperature, humidity, and wind speed for a given location.

Inputs:

• latitude (number) — latitude coordinate of the target location

• longitude (number) — longitude coordinate of the target location

Setup

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

Usage

This server communicates over stdio, so it's meant to be launched by an MCP-compatible client, not run standalone.

Claude Code

Add a .mcp.json file in your project root (replace cwd with the absolute path where you cloned this repo):

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["tsx", "server.ts"],
      "cwd": "/absolute/path/to/mcp-weather"
    }
  }
}

Claude Desktop

Add the same mcpServers block to your claude_desktop_config.json (Settings → Developer → Edit Config).

After saving the config, restart the client. The get_weather tool will be available automatically.

Remote / Hosted Usage

This repo also includes remote-server.ts, which exposes the same get_weather tool over Streamable HTTP instead of stdio. Deploy it to any Node hosting platform (e.g. Render) and clients can connect via URL — no local clone or install needed on the client side.

Deploying (e.g. on Render):

• Build Command: npm install

• Start Command: npm run start:remote

• No environment variables required (the host's PORT is picked up automatically)

A live, hosted instance is running at https://mcp-weather-1cyg.onrender.com/mcp — you can connect to it directly without deploying your own.

Connecting a client to the remote URL:

• Claude Code: add to .mcp.json:

  {
    "mcpServers": {
      "weather": {
        "type": "http",
        "url": "https://mcp-weather-1cyg.onrender.com/mcp"
      }
    }
  }

• Claude Desktop: Desktop does not support a plain url field in claude_desktop_config.json for remote servers. Instead, go to Settings → Connectors → Add Custom Connector and paste the URL there.

Note: free hosting tiers typically spin down after a period of inactivity, so the first request after idling may take 10-30 seconds while the instance wakes up.

Development

Run the server directly (useful for testing it starts without errors):

npm start

To run the remote/HTTP variant locally:

npm run start:remote