met-mcp

MCP-сервер для прогнозов погоды от MET Norway (Yr). Создан как учебный проект.

Доступен тремя способами:

• npm: met-mcp — запуск локально через stdio

• Remote: https://met-mcp.met-mcp-worker.workers.dev/mcp — Streamable HTTP на Cloudflare Workers, добавьте его как коннектор claude.ai

• MCP registry: io.github.trondbjoroy/met-mcp

Инструменты

• geocode_location(name, count) — найти координаты по названию места. Использует бесплатный геокодер Open-Meteo, потому что у MET нет API геокодирования.

• get_forecast(latitude, longitude, hours) — почасовой прогноз от MET Locationforecast 2.0. Работает по всему миру, лучше всего в Северной Европе.

• get_nowcast(latitude, longitude) — прогноз осадков на основе радара на ближайшие 2 часа. Только для Северной Европы.

• get_weather_alerts(latitude?, longitude?) — официальные предупреждения об опасности в Норвегии (MetAlerts). Опустите координаты, чтобы получить предупреждения для всей Норвегии.

• get_sun_events(latitude, longitude, date, utc_offset) — восход, закат и солнечный полдень. По всему миру.

• get_ocean_forecast(latitude, longitude, hours) — высота волн и температура моря вдоль побережья Норвегии.

• find_weather_stations(latitude, longitude, count) — ближайшие официальные метеостанции (Frost).

• get_historical_weather(station_id, from, to, elements) — ежедневные исторические наблюдения из архива Frost; некоторые станции ведут наблюдения более 100 лет.

Для двух инструментов Frost требуется бесплатный идентификатор клиента с https://frost.met.no/auth/requestCredentials.html, задаваемый как переменная окружения FROST_CLIENT_ID (или секрет Cloudflare для воркера). Остальным инструментам ничего не нужно.

Определения инструментов находятся в src/tools.ts, общие для stdio-сервера и воркера.

Related MCP server: OpenWeatherMap MCP Server

Сборка и тестирование

npm install
npm run build
npm test

Тест запускает сервер через stdio и вызывает оба инструмента с использованием живых API.

Использование с Claude Code

claude mcp add met-weather -- node C:\Users\trond\met-mcp\dist\index.js

Затем спросите Claude: "Какая погода завтра в Бергене?"

Условия использования MET

• Отправляйте идентифицирующий User-Agent с контактной информацией. Установите переменную окружения MET_USER_AGENT, например met-mcp/0.1.0 you@example.com.

• Отправляйте не более 4 знаков после запятой в координатах. Сервер округляет за вас.

• Лицензия на данные: NLOD / CC BY 4.0. Указывайте MET Norway при отображении данных.

Удалённая версия

worker/ содержит развёртывание Cloudflare Workers: те же два инструмента, обслуживаемые через MCP Streamable HTTP с помощью createMcpHandler (MCP SDK v2). Разрабатывайте с помощью npm run dev, публикуйте с помощью npm run deploy (обе команды из worker/).

Как это работает

• src/index.ts — это весь сервер. Он общается по MCP через stdio: JSON-RPC на stdin/stdout.

• Каждый инструмент объявляет схему ввода с помощью Zod. MCP-клиент (Claude) читает схему и проверяет аргументы.

• Результаты инструментов — это блоки content. Этот сервер возвращает JSON в виде текста, урезанного до того, что нужно LLM — сырой ответ MET содержит ~90 временных шагов с гораздо большим количеством полей.

• Никогда не пишите в stdout с помощью console.log. Это повреждает поток протокола. Логируйте в stderr.