Skip to main content
Glama
MCP weather server

MCP weather server

by uidoyen

MCP weather server (Python)

A minimal Model Context Protocol server with one tool, get_forecast, that answers "what's the weather in a city on a day?" using the free Open-Meteo API (no key needed). It's the code from the video How to Build an MCP Server in Python (From Scratch): [VIDEO LINK]

Claude Desktop  --(MCP over stdio)-->  weather.py  --(HTTPS)-->  Open-Meteo

Requirements

  • Python 3.10 or newer

  • uv

  • Claude Desktop, or any other MCP host

Related MCP server: Weather MCP Server

Run it

uv sync

Test it on its own in the MCP Inspector (a local web page for trying out servers):

uv run mcp dev weather.py

In the Inspector: Connect, then Tools and List Tools, then pick get_forecast, enter a city (Lisbon) and a date within the next 16 days (YYYY-MM-DD), and click Run Tool.

Or test it from the terminal, the way a host talks to it (lists the tools, then calls the tool twice):

uv run python check_client.py

Connect it to Claude Desktop

  1. Find your full paths: which uv (on Windows where uv), and pwd in this folder.

  2. Open Claude Desktop's config file (Claude Desktop: Settings, Developer, Edit Config), or create it if it's missing:

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

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

  3. Add the weather entry from claude_desktop_config.example.json inside mcpServers, with your two paths. Keep any servers already there.

  4. Quit Claude Desktop completely and reopen it. Ask: Is it sunny in Lisbon on Saturday?

Claude asks for your permission before it runs the tool, and shows the arguments it chose.

If the tool doesn't appear

  1. The path must be absolute. --directory needs the full path to this folder.

  2. Claude may not find uv. Use the full path from which uv as command.

  3. Nothing may print to stdout. Over stdio, stdout carries the protocol messages; a stray print() breaks them. Log with logging (it goes to stderr) instead.

Claude Desktop's own log for the server is in ~/Library/Logs/Claude/mcp-server-weather.log (macOS).

How it works

  • MCPServer("weather") is the server; @mcp.tool() turns get_forecast into a tool.

  • The type hints (city: str, day: str) become the tool's input schema; the docstring becomes the description the model reads.

  • The tool looks the city up with Open-Meteo's geocoding API, gets the daily forecast, and returns one short sentence, such as Rainy, 20 °C on 2026-11-07.

  • An unknown city returns a message instead of raising an error, so the model can tell the user.

Credits

Weather data by Open-Meteo, free for non-commercial use. Built with the MCP Python SDK.

License

MIT, see LICENSE.

Available Tools

1 tool
get_forecastA

Get the weather forecast for a city on one day.

Args: city: City name, for example Lisbon day: Date as YYYY-MM-DD, within the next 16 days

Inputs: day (required), city (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With a single tool there is nothing to confuse it with; the purpose (daily forecast for a city) is unambiguous. An agent cannot misselect among tools here.

    Naming Consistency4/5

    get_forecast follows a clear verb_noun convention, though with only one tool there is no pattern to actually verify. It is readable and predictable, but consistency is untested.

    Tool Count3/5

    One tool is thin even for a narrowly scoped weather server; users would reasonably expect current conditions or multi-day output. It is not mismatched to the stated purpose, but it is on the sparse edge.

    Completeness2/5

    The surface covers only a single-day forecast, with no tool for current conditions, multi-day ranges, alerts, or location lookup/geocoding. These are standard weather operations that agents would commonly need and cannot work around with this set.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables users to get current weather information for any city using the Open-Meteo API. Provides detailed meteorological data including temperature, precipitation, day/night status, and hourly forecasts through natural language queries.
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to retrieve 24-hour weather forecasts and city information through natural language queries using city names or coordinates.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides current weather and multi-day forecasts for any city using the Open-Meteo API, with natural language city names and optional forecast duration.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides weather forecast tools using Open-Meteo, enabling users to get current conditions, multi-day forecasts, and umbrella recommendations through natural language queries.
      -