mcp-meteoblue

Ein MCP-Server für die meteoblue Weather API, geschrieben in JavaScript. Er ermöglicht es MCP-Clients, Orte zu suchen, Vorhersagen mithilfe der im Free Weather API verfügbaren Pakete abzurufen und Vorhersage-Meteogrammbilder anzufordern.

Tools

• search_locations löst Städte, Postleitzahlen und IATA/ICAO-Flughafencodes mit der meteoblue Location Search auf.

• get_forecast akzeptiert entweder einen Ortsnamen oder Koordinaten und gibt den Vorhersage-JSON zurück. Standardmäßig werden aktuelle, stündliche und tägliche Wetterdaten geliefert.

• get_forecast_image akzeptiert entweder einen Ortsnamen oder Koordinaten und gibt ein Vorhersagebild direkt an den MCP-Client zurück.

Ortsnamen, die an Vorhersage– oder Bildtools übergeben werden, werden immer über die offizielle meteoblue Location Search API aufgelöst. Die Eingaben für Vorhersagepakete sind auf die in der Free Weather API-Dokumentation aufgeführten Pakete beschränkt.

[!NOTE] Die aktuelle Free Weather API-Dokumentation von meteoblue besagt, dass Bilder eine höhere Zugriffsstufe erfordern. Das Bildtool ist für Schlüssel mit einer Image-API-Berechtigung enthalten und gibt andernfalls einen klaren Autorisierungsfehler zurück.

Related MCP server: mcp-weather-server

Anforderungen

• Node.js 20 oder neuer

• Ein meteoblue API-Schlüssel

Den Schlüssel privat halten. Dieser Server liest ihn aus METEOBLUE_API_KEY; er ist niemals Teil der Paket– oder MCP-Toolargumente.

Von npm ausführen

Fügen Sie diesen stdio-Server zu Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "meteoblue": {
      "command": "npx",
      "args": ["-y", "mcp-meteoblue"],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Oder führen Sie ihn direkt aus:

METEOBLUE_API_KEY=your_api_key_here npx -y mcp-meteoblue

Der Server verwendet stdio und erzeugt deshalb absichtlich keine normale Terminalausgabe, während er auf einen MCP-Client wartet.

Docker

Erstellen Sie das Image lokal:

docker build -t mcp-meteoblue .

Konfigurieren Sie einen Docker-basierten stdio-Server in Ihrem MCP-Client:

{
  "mcpServers": {
    "meteoblue": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "METEOBLUE_API_KEY",
        "mcp-meteoblue"
      ],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Der Container läuft als unprivilegierter node-Benutzer. Lassen Sie stdin mit -i offen, da die MCP-Kommunikation stdio verwendet.

Lokal entwickeln

npm install
npm test
METEOBLUE_API_KEY=your_api_key_here npm start

Richten Sie einen MCP-Client auf node /absolute/path/to/mcp-meteoblue/src/index.js aus und setzen Sie die Umgebungsvariable in dessen Konfiguration.

Veröffentlichungen

GitHub Actions führt bei jedem Push und Pull Request die Testsuite aus und validiert das npm-Tarball auf Node.js 20, 22, 24 und 26. Dependabot prüft wöchentlich die npm- und GitHub-Actions-Abhängigkeiten.

Das Pushen eines v*-Git-Tags löst .github/workflows/publish.yml aus. Der Workflow verwendet npm Trusted Publishing (OIDC) und hängt automatisch Provenance an. Konfigurieren Sie den npm Trusted Publisher mit:

• GitHub-Inhaber: unixfox

• Repository: mcp-meteoblue

• Workflow: publish.yml

• Umgebung: npm

Wenn Trusted Publishing konfiguriert ist, wird kein npm-Token in GitHub gespeichert.

API-Umfang

Der Server ruft nur auf:

• https://www.meteoblue.com/{language}/server/search/query3

• https://my.meteoblue.com/packages/{packages}

• https://my.meteoblue.com/images/{forecast-image-type}

Er stellt nicht die meteoblue History, Dataset, Maps, Measurements oder andere APIs bereit.

Lizenz

MIT