mcp-weather-ts

TypeScript MCP-сервер, который предоставляет погоду в США из National Weather Service API таким хостам, как Cursor.

Хост запускает node build/index.js и общается по JSON-RPC через stdio. Модель никогда не вызывает 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 и полный путь к build\index.js вместо ${workspaceFolder}.

3. Откройте Customize → MCP (или Cursor Settings → MCP) и включите weather.

4. После изменения src/ снова запустите npm run build и выключите/включите сервер, чтобы Cursor перезапустил процесс.

Не используйте console.log после подключения сервера: stdout — это канал MCP. Для логов используйте console.error.

Что можно вызывать

Инструменты

Модель (или вы, через запрос в чате агента) вызывает их с помощью 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} (четыре знака после запятой), затем перейдите по properties.forecast или properties.forecastHourly.

• NWS требует заголовок User-Agent (задан в weather-api-call.ts).

• Покрытие — США (и некоторые территории). Другие координаты часто не работают.

Устранение неполадок

Cursor: Output → MCP Logs.

Лицензия

ISC