Wetterabfrage-MCP-Server (Python-Version) 🌤

Ein Wetterabfrage-MCP-Server, erstellt mit dem offiziellen mcp Python SDK (FastMCP). Er kommuniziert über stdio mit beliebigen MCP-Clients (z. B. Claude Desktop, WorkBuddy) und ermöglicht dem KI-Assistenten, das aktuelle Wetter einer angegebenen Stadt in Echtzeit abzufragen.

💡 Die Wetterdaten stammen von Open-Meteo – ohne Registrierung und ohne API-Key.

✨ Funktionen

• ⚡ Reine stdio-Kommunikation: Plug-and-Play, kein offener Port nötig und kein HTTP-Dienst erforderlich.

• 🌍 Mehrsprachige Städtenamen: Unterstützt chinesische und englische Städtenamen wie 北京, Beijing, Tokyo.

• 🔒 Schlüssellos: Daten von Open-Meteo – es werden keine personenbezogenen Daten erfasst und keine Request-Bodies gesendet.

• 🛡 Robuste Fehlerbehandlung: Bei nicht vorhandener Stadt oder Netzwerkfehlern wird eine freundliche chinesische Meldung zurückgegeben, ohne dass der Dienst abstürzt.

• 🎨 Freundliches Rückgabeformat: Strukturierter Text + Emoji, sodass der Client die Daten direkt anzeigen kann.

🛠 Bereitgestellte Werkzeuge

Rückgabebeispiel

📍 北京（中国）当前天气
🌤  天气：晴
🌡  温度：27.3°C（体感 28.1°C）
💧 湿度：52%
🍃 风速：12.4 km/h
🕒 观测时间：2026-08-19T13:00

📋 Systemanforderungen

• Python >= 3.10 (empfohlen: 3.13, auf dem lokalen Rechner getestet)

• Internetzugang erforderlich (zum Aufruf der Open-Meteo API)

🚀 Installation und Start

git clone https://github.com/<your-name>/weather-mcp-server-py.git
cd weather-mcp-server-py

# 创建虚拟环境（可选但推荐）
python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 运行（stdio 模式，通常由 MCP 客户端拉起）
python weather_server.py

Dieser Dienst kommuniziert über die Standard-Eingabe/-Ausgabe (stdio) mit dem Client. python weather_server.py startet standardmäßig im stdio-Modus.

🔌 Einbindung in MCP-Clients

Am Beispiel von Claude Desktop / WorkBuddy tragen Sie z. B. in claude_desktop_config.json bzw. mcp.json die folgende Konfiguration ein (ersetzen Sie python3 durch den absoluten Pfad Ihres Python-Interpreters; unter Windows verwenden Sie python.exe):

{
  "mcpServers": {
    "weather": {
      "command": "python3",
      "args": ["/absolute/path/to/weather_server.py"]
    }
  }
}

Nach dem Speichern und Neustarten des Clients können Sie im Chat nach „Wetter in Beijing“ fragen; das Modell ruft dann automatisch das Werkzeug get_weather auf.

📁 Projektstruktur

weather-mcp-server-py/
├── weather_server.py   # MCP 服务主实现（FastMCP）
├── requirements.txt    # 依赖清单
└── README.md           # 本说明

🧰 Technische Details

• Stadt → Koordinaten: Verwendung der Open-Meteo Geocoding API;

• Aktuelles Wetter: Verwendung der Open-Meteo Forecast API. Das current-Feld liefert in einem Aufruf Temperatur / gefühlte Temperatur / Luftfeuchtigkeit / Windgeschwindigkeit / Wettercode;

• Wettercode → chinesische Beschreibung: eingebaute Zuordnungstabelle der WMO-Wettercodes;

• Falls zur Laufzeit das Netzwerk nicht verfügbar ist oder die Stadt nicht gefunden wird, wird eine freundliche chinesische Fehlermeldung zurückgegeben, sodass das Werkzeug immer einen String liefert.

🤝 Mitwirken

Beiträge sind willkommen: Issues und Pull Requests, z. B. für weitere Wetterparameter, zusätzliche Client-Beispiele oder mehr Tests.

📄 Lizenz

MIT © 2026 Mitwirkende von weather-mcp-server-py