Skip to main content
Glama

mcp-weather

A minimal MCP (Model Context Protocol) server exposing weather tools, backed by the free Open-Meteo API. Built as a practice project for MCP + Claude Code.

Tools

  • get_current_weather({ city }) — current temperature, windspeed, and conditions for a city.

  • get_forecast({ city, days? }) — daily max/min temperature and conditions for days days (1-7, default 3).

No API key is required.

Related MCP server: Simple Weather MCP

Setup

npm install
npm run build

Test

Runs the unit tests for the pure formatting/mapping logic in src/weatherFormat.ts:

npm test

Debug with MCP Inspector

Launches an interactive web UI to call tools directly, without Claude Code:

npm run inspector

Use with Claude Code

This project's .mcp.json registers the server as weather, running node dist/index.js over stdio. Open this project in Claude Code (or restart it here), confirm weather shows as connected (/mcp), and ask a weather-related question — Claude Code will invoke the tools as needed.

Project layout

  • src/weatherFormat.ts — pure formatting/mapping logic (weather codes, day clamping, text formatting), unit tested.

  • src/openMeteo.ts — thin fetch wrappers around Open-Meteo's geocoding and forecast APIs.

  • src/index.ts — MCP server entrypoint: registers get_current_weather and get_forecast, connects over stdio.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides real-time weather data, hourly forecasts, and daily summaries using the free Open-Meteo API with no API key required. It enables users to search for weather conditions by specific coordinates or city names across multiple measurement units.
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A cross-platform MCP server that provides weather forecasts by coordinates, location name, or IP address without requiring API keys. It leverages Open Meteo and OpenStreetMap to deliver fast, single-query weather lookups.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that wraps the Open-Meteo API to provide current weather, forecasts, and historical data for any location without requiring an API key.
    MIT