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

1. Voraussetzungen

2. Projekt-Setup

3. Anwendung

4. Entwicklungshandbuch

5. Auf GitHub hochladen

6. Fehlerbehebung

Related MCP server: Weather Query MCP Server

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

1. Laden Sie das Installationsprogramm von der offiziellen Node.js-Website herunter und installieren Sie es.

2. Sobald die Installation abgeschlossen ist, überprüfen Sie sie, indem Sie den folgenden Befehl im Terminal ausführen:

node -v
npm -v

Git installieren

1. Laden Sie das Installationsprogramm von der offiziellen Git-Website herunter und installieren Sie es.

2. Sobald die Installation abgeschlossen ist, überprüfen Sie sie, indem Sie den folgenden Befehl im Terminal ausführen:

git --version

Projekt-Setup

Erstellen eines neuen Projekts

1. Erstellen Sie ein neues Verzeichnis und navigieren Sie dorthin:

mkdir my-weather-mcp
cd my-weather-mcp

2. Initialisieren Sie Ihr npm-Projekt:

npm init -y

3. Installieren Sie die erforderlichen Pakete:

npm install @modelcontextprotocol/sdk axios zod typescript @types/node https-proxy-agent
npm install --save-dev ts-node

4. Erstellen Sie eine TypeScript-Konfigurationsdatei:

npx tsc --init

5. Bearbeiten Sie Ihre tsconfig.json Datei wie folgt:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    "outDir": "./build",
    "strict": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

6. Bearbeiten Sie den Abschnitt „Skripts“ Ihrer Datei package.json wie folgt:

"scripts": {
  "build": "tsc && node -e \"import('fs').then(fs => fs.default.chmodSync('build/index.js', '755'))\"",
  "start": "node build/index.js",
  "inspect": "npx @modelcontextprotocol/inspector build/index.js",
  "dev": "ts-node src/index.ts"
}

7. Erstellen Sie die Projektverzeichnisstruktur:

mkdir -p src test

Klonen eines vorhandenen Projekts

Wenn Sie ein vorhandenes Projekt verwenden möchten, klonen Sie es:

git clone https://github.com/terisuke/my-weather-mcp.git
cd my-weather-mcp
npm install

Anwendung

Erstellen und Ausführen

Verwenden Sie zum Erstellen und Ausführen des Projekts die folgenden Befehle:

npm run build && npm run start

Verwenden des Inspektors

Um den Wetterdienst mit dem MCP Inspector zu testen, führen Sie den folgenden Befehl aus:

npm run build && npm run inspect

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

my-weather-mcp/
├── build/              # コンパイルされたJavaScriptファイル
├── src/                # TypeScriptソースコード
│   └── index.ts        # メインのアプリケーションコード
├── test/               # テストファイル
├── package.json        # プロジェクト設定
├── tsconfig.json       # TypeScript設定
└── README.md           # このファイル

Korrigieren des Codes

1. Bearbeiten Sie die Datei src/index.ts um die Funktionalität hinzuzufügen oder zu ändern.

2. Um Ihre Änderungen zu testen, führen Sie den folgenden Befehl aus:

npm run build && npm run inspect

3. Wenn Sie mit der Funktion der Änderungen zufrieden sind, übernehmen Sie sie.

Auf GitHub hochladen

Erstellen Ihres ersten GitHub-Repositorys

1. Gehen Sie zu GitHub und erstellen Sie ein Konto oder melden Sie sich an.

2. Klicken Sie oben rechts auf die Schaltfläche „+“ und wählen Sie „Neues Repository“ aus.

3. Geben Sie einen Repository-Namen ein (z. B. my-weather-mcp ) und fügen Sie optional eine Beschreibung hinzu.

4. 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

1. Initialisieren Sie in Ihrem lokalen Projektverzeichnis ein Git-Repository:

git init

2. Fügen Sie Ihre Änderungen zum Staging-Bereich hinzu:

git add .

3. Übernehmen Sie die Änderungen:

git commit -m "初回コミット：MCP天気サービスの実装"

4. Fügen Sie ein Remote-Repository hinzu (mithilfe der Repository-URL von GitHub):

git remote add origin https://github.com/ユーザー名/my-weather-mcp.git

5. Übertragen Sie die Änderungen in das Remote-Repository:

git push -u origin main

Übertragen von Änderungen an ein vorhandenes Repository

1. Fügen Sie Ihre Änderungen zum Staging-Bereich hinzu:

git add .

2. Übernehmen Sie die Änderungen:

git commit -m "変更内容の説明"

3. Übertragen Sie die Änderungen in das Remote-Repository:

git push

Erstellen einer Pull-Anforderung

1. Gehen Sie zur Repository-Seite auf GitHub.

2. Klicken Sie auf die Registerkarte „Pull Requests“ und dann auf die Schaltfläche „Neuer Pull Request“.

3. Wählen Sie den Basiszweig und den Vergleichszweig aus.

4. Klicken Sie auf die Schaltfläche „Pull Request erstellen“.

5. 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:

// 誤ったインポート
import { McpServer } from "@modelcontextprotocol/sdk";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/transports";

// 正しいインポート
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

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:

export HTTP_PROXY=http://プロキシサーバー:ポート
export HTTPS_PROXY=https://プロキシサーバー:ポート

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