mcp-weather-ts

TypeScript MCP サーバーで、National Weather Service API の米国気象情報を Cursor などのホストに公開します。

ホストは node build/index.js を起動し、stdio を介して JSON-RPC で通信します。モデルは NWS 自体を呼び出すのではなく、このサーバーのツールを呼び出します(リソースを読み取ったり、プロンプトを使用したりすることもできます)。

MCP の仕組み(ツール、リソース、プロンプト、トランスポート): docs/create-mcp.readme.md。

要件

• Node.js 22+ (このリポジトリは ESM と fetch を使用)

• npm

• https://api.weather.gov へのネットワークアクセス(米国内のみ)

Related MCP server: weather

セットアップ

npm install
npm run build

tsc は JavaScript を build/ に書き出します。Cursor は ビルド済み ファイルを実行する必要があり、src/index.ts ではありません。

スクリプト

Cursor でのマウント

1. ビルド(npm run build)。

2. このプロジェクトに .cursor/mcp.json を追加:

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

すべての Cursor プロジェクトでは、%USERPROFILE%\.cursor\mcp.json を使用し、${workspaceFolder} の代わりに build\index.js への絶対パスを指定します。

3. Customize → MCP(または Cursor Settings → MCP)を開き、weather を有効にします。

4. src/ を変更したら、npm run build をもう一度実行し、サーバーをオフ/オンに切り替えて Cursor にプロセスを再起動させます。

サーバー接続後は console.log を使用しないでください。stdout は MCP の通信路です。ログには console.error を使用してください。

呼び出せるもの

ツール

モデル(または Agent チャットで依頼したあなた)は、tools/call でこれらを呼び出します。

チャット例:

• 「CA の天気警報はありますか?」

• 「39.7456, -97.0892 の予報」

引数例:

{ "state": "CA" }

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

リソース

エージェントに weather://nws-guide を読むよう依頼するか、クライアントで resources/read を使用してください。

プロンプト

Cursor では、Check weather プロンプトを選択し、place に入力します。

プロジェクト構成

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

src/index.ts の起動順序:

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

2. registerWeatherTools / registerWeatherResources / registerWeatherPrompts

3. connectStdioTransport(server)

NWS のメモ

• 予報は /points/{lat},{lon}/forecast には ありません。/points/{lat},{lon}(小数第4位まで)を読み込み、その後 properties.forecast または properties.forecastHourly を参照してください。

• NWS は User-Agent ヘッダーを要求します(weather-api-call.ts で設定)。

• 対象は米国(および一部の準州)です。それ以外の座標は多くの場合失敗します。

トラブルシューティング

Cursor: Output → MCP Logs。

ライセンス

ISC