날씨 MCP 서버

미국 기상청(NWS) API를 사용하여 미국 지역의 날씨 정보와 경보를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 모델 컨텍스트 프로토콜을 통해 AI 에이전트가 사용하도록 설계되었습니다.

특징

미국 모든 주의 날씨 알림을 받을 수 있는 도구
좌표를 사용하여 미국 내 모든 지역의 자세한 날씨 예보를 얻는 도구
온도, 바람 상태 및 간단한 예보 설명을 지원합니다.
국립 기상청의 실시간 데이터

필수 조건

Node.js(v16 이상)
npm 또는 yarn 패키지 관리자

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

애플리케이션을 빌드하세요:

npm run build

MCP 도구

서버는 AI 에이전트가 사용할 수 있는 두 가지 MCP 도구를 제공합니다.

알림 받기

특정 미국 주의 날씨 알림을 받으세요.

매개변수:

state : 두 글자 주 코드(예: CA, NY)

응답 예시:

{
  "content": [
    {
      "type": "text",
      "text": "Active alerts for CA: ..."
    }
  ]
}

예측 얻기

좌표를 사용하여 특정 위치의 날씨를 예보합니다.

매개변수:

latitude : 위치의 위도(-90~90)
longitude : 위치의 경도(-180 ~ 180)

응답 예시:

{
  "content": [
    {
      "type": "text",
      "text": "Morning: Temperature: 72°F, Wind: 5mph NW, Partly cloudy..."
    }
  ]
}

프로젝트 구조

weather/
├── src/
│   └── index.ts    # Main server code with MCP tool implementations
├── build/          # Compiled JavaScript files
├── package.json    # Project dependencies and scripts
└── tsconfig.json   # TypeScript configuration

기술적 세부 사항

TypeScript로 구축됨
MCP(Model Context Protocol) 서버를 구현합니다.
MCP 서버 구현을 위해 @modelcontextprotocol/sdk를 사용합니다.
국립 기상청(NWS) API와의 인터페이스
Node16 모듈 해상도를 갖춘 ES2022 타겟

개발

서버를 수정하거나 확장하려면:

src/index.ts 파일을 변경하세요
애플리케이션을 다시 빌드합니다.

npm run build

종속성

@modelcontextprotocol/sdk: MCP 서버 구현 프레임워크
zod: 도구 매개변수에 대한 런타임 유형 검사 및 검증
TypeScript: 유형 안전을 위한 개발 종속성

특허

아이에스씨

노트

이 서버는 National Weather Service API를 사용하므로 미국 지역에서만 작동합니다.
API 요청은 속도 제한이 있으며 User-Agent 헤더가 필요합니다.
모든 좌표는 십진수 형식이어야 합니다.
이는 독립형 CLI 애플리케이션이 아니라 모델 컨텍스트 프로토콜을 통해 AI 에이전트에 도구를 제공하는 서버입니다.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

국립 기상청 API를 사용하여 AI 에이전트가 미국 지역의 날씨 경보와 자세한 예보를 검색할 수 있는 도구를 제공하는 모델 컨텍스트 프로토콜 서버입니다.

Weather MCP Server