MCP-Wetterserver

Ein auf FastMCP basierender MCP-Server für Wetterabfragen, der aktuelles Wetter, Wettervorhersagen, Umrechnungen zwischen Celsius und Fahrenheit, Ressourcen für beliebte Städte sowie Prompts für Reise-Wetterberatungen bietet.

Das Projekt enthält zwei Start-Einstiegspunkte:

• server.py: Lokaler stdio-Modus, geeignet für lokale MCP-Clients wie Claude Desktop, Cursor, Cherry Studio usw.

• server_remote.py: Streamable HTTP-Modus, geeignet für die Bereitstellung auf Remote-Hosting-Plattformen wie ModelScope.

Funktionen

• get_weather(city: str): Fragt das aktuelle Wetter für eine bestimmte Stadt ab.

• get_forecast(city: str, days: int = 3): Fragt die Wettervorhersage für eine bestimmte Stadt ab (Standard: 3 Tage).

• temperature_convert(value: float, from_unit: str): Rechnet zwischen Celsius und Fahrenheit um.

• weather://cities: Gibt eine Ressourcenliste mit häufig verwendeten Städten zurück.

• travel_advisor(destination: str, date: str): Generiert einen Prompt für eine Reise-Wetterberatung.

Die Wetterdaten stammen von wttr.in, es sind keine zusätzlichen API-Token erforderlich.

Systemanforderungen

• Python >= 3.12

• Es wird empfohlen, uv für die Abhängigkeitsverwaltung zu verwenden.

Abhängigkeiten installieren

uv sync

Falls uv nicht verwendet wird, können die Abhängigkeiten auch in einer virtuellen Umgebung installiert werden:

pip install "mcp[cli]>=1.27.0" "httpx>=0.28.1"

Lokale Ausführung

stdio-Modus:

uv run python server.py

Beispiel für die MCP-Client-Konfiguration:

{
  "mcpServers": {
    "weather-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"]
    }
  }
}

Remote-Ausführung

Streamable HTTP-Modus:

uv run python server_remote.py

Standard-Listening:

http://0.0.0.0:8000/mcp/

Beispiel für die Remote-MCP-Client-Konfiguration:

{
  "mcpServers": {
    "weather-server": {
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

Hinweise zur Bereitstellung auf ModelScope

Beim Erstellen oder Bereitstellen eines MCP-Servers auf ModelScope können Sie die GitHub-Repository-Adresse dieses Projekts angeben und die Remote-Einstiegsdatei verwenden:

python server_remote.py

Der Dienst startet im Streamable HTTP-Modus und lauscht auf 0.0.0.0:8000. Der MCP-Endpunkt lautet:

/mcp/

Wenn die Plattform benutzerdefinierte Startbefehle unterstützt, wird Folgendes empfohlen:

uv run python server_remote.py

Oder verwenden Sie es, nachdem die Abhängigkeiten in der Plattformumgebung vorinstalliert wurden:

python server_remote.py

Projektstruktur

.
├── README.md
├── pyproject.toml
├── server.py
├── server_remote.py
└── uv.lock

Lizenz

Falls eine Open-Source-Veröffentlichung geplant ist, ergänzen Sie bitte die Lizenzdatei entsprechend den tatsächlichen Gegebenheiten.