mcp-weather-ts

Ein TypeScript-MCP-Server, der US-Wetterdaten von der National Weather Service API für Hosts wie Cursor bereitstellt.

Der Host startet node build/index.js und kommuniziert per JSON-RPC über stdio. Das Modell ruft NWS nie selbst auf; es ruft die Tools dieses Servers auf (und kann eine Ressource lesen oder eine Prompt verwenden).

So funktioniert MCP (Tools, Ressourcen, Prompts, Transport): docs/create-mcp.readme.md.

Voraussetzungen

• Node.js 22+ (dieses Repo verwendet ESM und fetch)

• npm

• Netzwerkzugriff auf https://api.weather.gov (nur US-Standorte)

Related MCP server: weather

Einrichtung

npm install
npm run build

tsc schreibt JavaScript nach build/. Cursor muss die erstellte Datei ausführen, nicht src/index.ts.

Skripte

In Cursor einbinden

1. Build ausführen (npm run build).

2. Füge in diesem Projekt .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "weather": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/build/index.js"]
    }
  }
}

Verwende für alle Cursor-Projekte %USERPROFILE%\.cursor\mcp.json und einen vollständigen Pfad zu build\index.js anstelle von ${workspaceFolder}.

3. Öffne Customize → MCP (oder Cursor Settings → MCP) und aktiviere weather.

4. Nachdem du src/ geändert hast, führe npm run build erneut aus und schalte den Server aus und wieder ein, damit Cursor den Prozess neu startet.

Verwende nach dem Verbinden des Servers kein console.log: stdout ist der MCP-Kanal. Nutze console.error für Logs.

Was du aufrufen kannst

Tools

Das Modell (oder du, indem du im Agent-Chat fragst) ruft diese mit tools/call auf.

Beispiel-Chat:

• „Gibt es Wetterwarnungen für CA?“

• „Vorhersage für 39.7456, -97.0892“

Beispiel-Argumente:

{ "state": "CA" }

{ "latitude": 39.7456, "longitude": -97.0892 }

Ressource

Bitte den Agenten, weather://nws-guide zu lesen, oder verwende resources/read in einem Client.

Prompt

Wähle in Cursor die Prompt Check weather und fülle place aus.

Projektstruktur

src/index.ts              Create McpServer, register, connect stdio
src/tools.ts              get_alerts, get_forecast, test_tool
src/resources.ts          weather://nws-guide
src/prompts.ts            check_weather
src/weather-api-call.ts   NWS fetch + types + alert formatting
src/createTransport.ts    StdioServerTransport + connect
tests/weather-api-call.test.ts
docs/create-mcp.readme.md How to design MCP servers

Startreihenfolge in src/index.ts:

1. new McpServer({ name: "weather", version: "1.0.0" })

2. registerWeatherTools / registerWeatherResources / registerWeatherPrompts

3. connectStdioTransport(server)

Hinweise zu NWS

• Vorhersagen liegen nicht unter /points/{lat},{lon}/forecast. Lade /points/{lat},{lon} (vier Nachkommastellen) und folge dann properties.forecast oder properties.forecastHourly.

• NWS verlangt einen User-Agent-Header (gesetzt in weather-api-call.ts).

• Die Abdeckung umfasst die USA (und einige Territorien). Andere Koordinaten schlagen oft fehl.

Fehlerbehebung

Cursor: Output → MCP Logs.

Lizenz

ISC