Skip to main content
Glama
mcp-weather-connector

mcp-weather-connector

by KDimkuz

mcp-weather-connector

MCP-Server, der einem KI-Agenten Zugriff auf die Wettervorhersage über Open-Meteo bietet – eine öffentliche API ohne Schlüssel und Registrierung.

Bewusst klein gehalten: Das Repository zeigt, wie die Werkzeugschicht für einen Agenten aufgebaut ist, nicht vom Wetter. Das Wetter ist hier ein verständlicher Anlass, um die Vertrauensgrenze zwischen Modell und Außenwelt sichtbar zu machen.

Wozu das?

Model Context Protocol ist ein Weg, einem Sprachmodell das Recht zu geben, Aktionen in externen Diensten auszuführen. Sobald dieses Recht besteht, stellt sich die Frage: Was geschieht, wenn das Modell dem Werkzeug Müll übergibt und ein anderer Dienst genau in diesem Moment einen 503 Fehler liefert.

Drei Lösungen werden in diesem Code ausdrücklich gezeigt:

Die Modelleingabe ist nicht vertrauenswürdig. Das Modell kann eine leere Zeichenkette, einen zehn Kilobyte langen Textblock oder Steuerzeichen übergeben. Alles wird in server.py vor dem Netzwerkaufruf abgeschnitten, nicht in der fremden API.

Fehler werden nach Typ unterschieden. Einen 4xx wiederzuholen ergibt keinen Sinn – es ist ein Anfragefehler, den Wiederholungen nicht beheben würden. Ein 5xx ist meist ein einmaliger Zwischenfall – eine Wiederholung mit Pause reicht. Die Logik liegt in _get_json und wird durch Tests mit einem Aufruf-Zähler überprüft.

Nach außen geht Text, nicht rohes JSON. Der Agent hat nichts weiter zu interpretieren und kann beim Nacherzählen keine Fehler machen. Eine 200-Antwort ohne das erforderliche Feld wird als Fehler gezählt, nicht als Grund, eine leere Antwort zu liefern.

Zusätzlich: Die Tage-Zahl außerhalb des Bereichs wird auf die Grenze begrenzt und nicht als Fehler behandelt. Wenn das Modell einen Vorhersage für 30 Tage erkennt, ist es sinnvoller, sieben zu liefern, als den Dialog mit einem Fehler zu beenden.

Related MCP server: open-meteo-mcp-server

Werkzeuge

Werkzeug

Funktion

current_weather(city)

Wetter aktuell: Temperatur, gefühlte Temperatur, Luftfeuchtigkeit, Wind

forecast(city, days=3)

Vorhersage für 1–7 Tage mit Niederschlag

locate(query)

Prüft, ob die Örtlichkeit existiert, und nennt das Land

locate existiert für ein einziges Szenario: Wenn der Agent sich bei der Schreibweise nicht sicher ist, ist es besser, den Benutzer zu fragen, als stillschweigend das Wetter der falschen Stadt zu liefern.

Installation

pip install -e .

Verbindung zu Claude Desktop

In claude_desktop_config.json:

{
  "mcpServers": {
    "weather": {
      "command": "mcp-weather"
    }
  }
}

Nach einem Neustart der Anwendung erscheinen die Werkzeuge in der Liste der verfügbaren Tools.

Entwicklung

pip install -e ".[dev]"
pytest
ruff check .

Die Tests decken genau das ab, was tatsächlich kaputt geht: leere und übermäßig große Eingabe, nicht numerische Tageswerte, 4xx ohne Wiederholung, 5xx mit einer Wiederholung, Erfolgen beim zweiten Versuch, eine 200-Antwort ohne Inhalt, unbekannter Wetterzustand. HTTP wird über respx simuliert; ein Netzwerk ist in den Tests nicht erforderlich.

Struktur

src/mcp_weather/
    client.py    — работа с Open-Meteo: типы, повторы, разбор ответа
    server.py    — MCP-слой: валидация входа и форматирование вывода
tests/
    test_tools.py

Der Netzcode ist bewusst von der MCP-Schicht getrennt: Client wird separat getestet, die Werkzeuge des Agent sind gehobenes eine dünne Schicht um verständliche Funktionen.

Lizenz

MIT

Available Tools

3 tools
current_weatherB

Текущая погода в указанном городе.

Args: city: Название населённого пункта, например «Ижевск» или «Berlin».

Inputs: city (required). Returns: result

forecastA

Прогноз погоды на несколько дней вперёд.

Args: city: Название населённого пункта. days: Сколько дней показать, от 1 до 7. Значения вне диапазона приводятся к границе, а не считаются ошибкой.

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

locateA

Проверяет, что населённый пункт существует, и уточняет страну.

Полезно, когда агент не уверен в написании: лучше уточнить у пользователя, чем молча выдать погоду не того города.

Inputs: query (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: current conditions, multi-day forecast, and location validation. There is no overlap or ambiguity between them, even though two tools accept a city argument.

    Naming Consistency3/5

    Naming is readable but inconsistent: current_weather is a noun phrase, forecast is a bare noun, and locate is a verb. A more consistent pattern like get_current_weather, get_forecast, and validate_location would be clearer.

    Tool Count5/5

    Three tools is well-scoped for a weather connector. Each tool covers a necessary function without unnecessary overlap or bloat.

    Completeness4/5

    The core weather workflows are covered: current conditions and multi-day forecasts, with optional location validation. Minor gaps exist, such as lacking unit selection or weather alerts, but these are not essential for most use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to retrieve current weather, forecasts, and summaries for any global location using the Open-Meteo API, with no API key required.
      Creative Commons Zero v1.0 Universal
    • A
      license
      A
      quality
      D
      maintenance
      Provides comprehensive access to Open-Meteo weather APIs, including forecasts, historical data, air quality, marine weather, and geocoding, enabling LLMs to retrieve weather information and location data.
      17
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides live weather data (current conditions, forecasts) and city geocoding through Open-Meteo API, enabling AI assistants to answer weather queries without an API key.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides weather forecasts and geocoding lookup using free Open-Meteo APIs, enabling LLMs to query real-time weather and multi-day forecasts for any location.
      1
      ISC