met-mcp

MET 노르웨이(Yr)의 일기 예보를 위한 MCP 서버입니다. 학습 프로젝트로 제작되었습니다.

세 가지 방법으로 사용할 수 있습니다:

• npm: met-mcp — stdio를 통해 로컬에서 실행

• 원격: https://met-mcp.met-mcp-worker.workers.dev/mcp — Cloudflare Workers의 Streamable HTTP, claude.ai 커넥터로 추가

• MCP 레지스트리: io.github.trondbjoroy/met-mcp

도구

• geocode_location(name, count) — 장소 이름의 좌표를 찾습니다. MET에는 지오코딩 API가 없으므로 무료 Open-Meteo 지오코더를 사용합니다.

• 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에서 무료 클라이언트 ID를 받아 FROST_CLIENT_ID 환경 변수(또는 worker용 Cloudflare 비밀)로 설정해야 합니다. 다른 도구는 아무것도 필요하지 않습니다.

도구 정의는 src/tools.ts에 있으며, stdio 서버와 worker가 공유합니다.

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 노르웨이를 출처로 표시하세요.

원격 버전

worker/에는 Cloudflare Workers 배포가 포함되어 있습니다. createMcpHandler(MCP SDK v2)를 사용하여 MCP Streamable HTTP로 동일한 두 도구를 제공합니다. npm run dev로 개발하고 npm run deploy로 배포합니다(둘 다 worker/에서 실행).

작동 방식

• src/index.ts가 전체 서버입니다. stdio를 통해 MCP를 사용합니다: stdin/stdout에서 JSON-RPC.

• 각 도구는 Zod로 입력 스키마를 선언합니다. MCP 클라이언트(Claude)가 스키마를 읽고 인수를 검증합니다.

• 도구 결과는 content 블록입니다. 이 서버는 LLM이 필요한 만큼만 잘라낸 JSON을 텍스트로 반환합니다. 원시 MET 응답에는 약 90개의 시간 단계와 훨씬 더 많은 필드가 있습니다.

• console.log로 stdout에 쓰지 마세요. 프로토콜 스트림이 손상됩니다. stderr로 로그를 남기세요.