mcp-weather-connector
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 |
| Wetter aktuell: Temperatur, gefühlte Temperatur, Luftfeuchtigkeit, Wind |
| Vorhersage für 1–7 Tage mit Niederschlag |
| 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.pyDer 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 toolscurrent_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
Scored across 3 tools
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 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.
Three tools is well-scoped for a weather connector. Each tool covers a necessary function without unnecessary overlap or bloat.
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
Related MCP Connectors
Global weather via Open-Meteo: forecast, historical, marine, air quality, geocoding, elevation.
Current weather and forecast lookup as an agent tool.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseAqualityDmaintenanceProvides 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.17MIT
- AlicenseNot gradedqualityDmaintenanceProvides 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
- AlicenseAqualityDmaintenanceProvides weather forecasts and geocoding lookup using free Open-Meteo APIs, enabling LLMs to query real-time weather and multi-day forecasts for any location.1ISC