MCP-Wetterdienst
Dieses Repository ist ein einfacher Dienst, der Wetterinformationen mithilfe des Model Context Protocol (MCP) bereitstellt. Sie können Wetterinformationen für mehrere Städte (Fukuoka, Tokio, Osaka, Moskau, New York usw.) abrufen.
Inhaltsverzeichnis
Voraussetzungen
Um dieses Projekt abzuschließen, benötigen Sie die folgende Software:
Node.js (Version 18 und höher)
npm (normalerweise mit Node.js installiert)
Git
So installieren Sie
Installieren von Node.js und npm
Laden Sie das Installationsprogramm von der offiziellen Node.js-Website herunter und installieren Sie es.
Sobald die Installation abgeschlossen ist, überprüfen Sie sie, indem Sie den folgenden Befehl im Terminal ausführen:
Git installieren
Laden Sie das Installationsprogramm von der offiziellen Git-Website herunter und installieren Sie es.
Sobald die Installation abgeschlossen ist, überprüfen Sie sie, indem Sie den folgenden Befehl im Terminal ausführen:
Projekt-Setup
Erstellen eines neuen Projekts
Erstellen Sie ein neues Verzeichnis und navigieren Sie dorthin:
Initialisieren Sie Ihr npm-Projekt:
Installieren Sie die erforderlichen Pakete:
Erstellen Sie eine TypeScript-Konfigurationsdatei:
Bearbeiten Sie Ihre
tsconfig.jsonDatei wie folgt:
Bearbeiten Sie den Abschnitt „Skripts“ Ihrer Datei
package.jsonwie folgt:
Erstellen Sie die Projektverzeichnisstruktur:
Klonen eines vorhandenen Projekts
Wenn Sie ein vorhandenes Projekt verwenden möchten, klonen Sie es:
Anwendung
Erstellen und Ausführen
Verwenden Sie zum Erstellen und Ausführen des Projekts die folgenden Befehle:
Verwenden des Inspektors
Um den Wetterdienst mit dem MCP Inspector zu testen, führen Sie den folgenden Befehl aus:
Sobald der Inspector ausgeführt wird, können Sie mit dem Wetterdienst interagieren, indem Sie in Ihrem Browser http://127.0.0.1:6274 aufrufen.
Wetterinformationen abrufen
Mit dem Inspector können Sie Wetterinformationen für die folgenden Städte abrufen:
Fukuoka
Tokio
Osaka
Moskau
New York
Andere Städte können angegeben werden, müssen aber von der Open-Meteo-API erkannt werden.
Entwicklungshandbuch
Dateistruktur
Korrigieren des Codes
Bearbeiten Sie die Datei
src/index.tsum die Funktionalität hinzuzufügen oder zu ändern.Um Ihre Änderungen zu testen, führen Sie den folgenden Befehl aus:
Wenn Sie mit der Funktion der Änderungen zufrieden sind, übernehmen Sie sie.
Auf GitHub hochladen
Erstellen Ihres ersten GitHub-Repositorys
Gehen Sie zu GitHub und erstellen Sie ein Konto oder melden Sie sich an.
Klicken Sie oben rechts auf die Schaltfläche „+“ und wählen Sie „Neues Repository“ aus.
Geben Sie einen Repository-Namen ein (z. B.
my-weather-mcp) und fügen Sie optional eine Beschreibung hinzu.Legen Sie für Ihr Repository fest, ob es öffentlich oder privat ist, und klicken Sie auf „Repository erstellen“.
Initialisieren und pushen Sie das lokale Repository
Initialisieren Sie in Ihrem lokalen Projektverzeichnis ein Git-Repository:
Fügen Sie Ihre Änderungen zum Staging-Bereich hinzu:
Übernehmen Sie die Änderungen:
Fügen Sie ein Remote-Repository hinzu (mithilfe der Repository-URL von GitHub):
Übertragen Sie die Änderungen in das Remote-Repository:
Übertragen von Änderungen an ein vorhandenes Repository
Fügen Sie Ihre Änderungen zum Staging-Bereich hinzu:
Übernehmen Sie die Änderungen:
Übertragen Sie die Änderungen in das Remote-Repository:
Erstellen einer Pull-Anforderung
Gehen Sie zur Repository-Seite auf GitHub.
Klicken Sie auf die Registerkarte „Pull Requests“ und dann auf die Schaltfläche „Neuer Pull Request“.
Wählen Sie den Basiszweig und den Vergleichszweig aus.
Klicken Sie auf die Schaltfläche „Pull Request erstellen“.
Geben Sie einen Titel und eine Beschreibung für Ihren Pull Request ein und klicken Sie auf die Schaltfläche „Pull Request erstellen“.
Fehlerbehebung
Häufige Probleme und Lösungen
ERR_PACKAGE_PATH_NOT_EXPORTED Fehler
Dieser Fehler tritt auf, wenn der Importpfad für das Paket @modelcontextprotocol/sdk falsch ist. Bitte beheben Sie das Problem wie folgt:
Netzwerkverbindungsfehler
Wenn beim Tätigen eines API-Aufrufs ein Netzwerkfehler auftritt, überprüfen Sie bitte Ihre Proxy-Einstellungen. Sie können einen Proxy verwenden, indem Sie die Umgebungsvariablen HTTP_PROXY oder HTTPS_PROXY festlegen:
Andere Probleme
Wenn das Problem weiterhin besteht, erstellen Sie bitte ein Problem mit den folgenden Informationen:
Die aufgetretene Fehlermeldung
Die von Ihnen verwendete Version von Node.js und npm
Befehl ausgeführt
Erwartetes vs. tatsächliches Verhalten