🌤️ Weather MCP Server (Node.js)

Ein Remote-MCP (Model Context Protocol)-Server, implementiert mit Node.js / Express. Über den Streamable HTTP transport wird das get_weather-Tool bereitgestellt, sodass MCP-Clients wie Claude Code das aktuelle Wetter für beliebige Städte in Echtzeit abfragen können.

Die Wetterdaten stammen von wttr.in – kostenlos, ohne Registrierung, ohne API-Key.

✨ Funktionen

• 🛰️ Remote-MCP-Dienst: Implementiert den Streamable-HTTP-Transport basierend auf dem offiziellen @modelcontextprotocol/sdk und unterstützt sowohl JSON- als auch SSE-Antwortmodi

• 🌆 Weltweite Städteunterstützung: Einfach den Stadtnamen übergeben (z. B. Beijing, Tokyo, Paris), um das lokale Wetter abzufragen

• 🔌 Vollständige Sitzungsverwaltung: Automatische Generierung/Validierung von Mcp-Session-Id, Unterstützung für Aufbau, Wiederverwendung und Schließung (DELETE) von Sitzungen

• 🧩 Einzeldatei, sofort einsatzbereit: Keine Datenbank, keine Konfigurationsdateien, eine einzige server.js genügt zum Starten

Related MCP server: MCP Weather Server — Demo

📦 Systemvoraussetzungen

• Node.js ≥ 18 (integriertes fetch, keine zusätzlichen Abhängigkeiten erforderlich)

🚀 Schnellstart

# 1. 安装依赖
npm install

# 2. 启动服务(默认端口 3000)
npm start

# 后台运行(日志写入 logs/server.log)
npm run start:bg

Nach erfolgreichem Start lautet die Dienstadresse:

http://localhost:3000/mcp

Häufig verwendete Skripte

🔌 MCP-Client konfigurieren

Registrieren Sie den Dienst in Claude Code oder einem anderen MCP-Client, der Streamable HTTP unterstützt, als Remote-MCP-Server.

Claude Code

Über die MCP-Serverliste hinzufügen (/mcp → Hinzufügen → HTTP):

{
  "type": "http",
  "url": "http://localhost:3000/mcp"
}

Per JSON-Konfigurationsdatei

{
  "mcpServers": {
    "weather": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

🧰 Bereitgestellte Tools

get_weather

Ruft das aktuelle Wetter für eine angegebene Stadt ab.

Parameter

Beispiel für die Rückgabe

当前 Beijing 的天气是晴(Sunny),温度 28°C(体感 30°C),湿度 45%,风速 12 km/h。

⚙️ Implementierungshinweise

• Sitzungsisolierung: Jede Sitzung hält eine eigene Server- + transport-Instanz (die connect()-Methode des SDK unterstützt nur einen Transport), verknüpft über den Mcp-Session-Id-Request-Header.

• Ablauf für neue Sitzungen: Ein POST ohne Mcp-Session-Id wird als Initialisierungsanfrage behandelt. Der Server generiert eine Sitzungs-ID und gibt sie über den Mcp-Session-Id-Response-Header zurück (über die exposedHeaders von CORS explizit für Browser-Clients sichtbar gemacht).

• Kompatibilitätsbehandlung: GET-SSE-Erkundungsanfragen ohne Sitzungs-ID halten einen offenen SSE-Stream aufrecht (statt 404/400 zurückzugeben), sodass Clients wie Claude Code weiterhin den POST-Initialisierungsablauf verwenden können.

• Zuverlässige Fehlerrückgabe: Bei einem Fehler des Wetter-API-Aufrufs wird ein Ergebnis mit isError: true zurückgegeben, anstatt die gesamte Anfrage zum Absturz zu bringen.

🗂️ Projektstruktur

.
├── server.js          # 全部服务逻辑(单文件)
├── package.json       # 项目配置与脚本
├── logs/              # 运行时日志(已被 .gitignore 忽略)
└── LICENSE            # MIT 许可证

📄 Lizenz

MIT