날씨 MCP 서버

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

특징

• 미국 모든 주의 날씨 알림을 받을 수 있는 도구

• 좌표를 사용하여 미국 내 모든 지역의 자세한 날씨 예보를 얻는 도구

• 온도, 바람 상태 및 간단한 예보 설명을 지원합니다.

• 국립 기상청의 실시간 데이터

Related MCP server: MCP Weather Server

필수 조건

• Node.js(v16 이상)

• npm 또는 yarn 패키지 관리자

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

npm install

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

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 타겟

개발

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

1. src/index.ts 파일을 변경하세요

2. 애플리케이션을 다시 빌드합니다.

npm run build

종속성

• @modelcontextprotocol/sdk: MCP 서버 구현 프레임워크

• zod: 도구 매개변수에 대한 런타임 유형 검사 및 검증

• TypeScript: 유형 안전을 위한 개발 종속성

특허

아이에스씨

노트

• 이 서버는 National Weather Service API를 사용하므로 미국 지역에서만 작동합니다.

• API 요청은 속도 제한이 있으며 User-Agent 헤더가 필요합니다.

• 모든 좌표는 십진수 형식이어야 합니다.

• 이는 독립형 CLI 애플리케이션이 아니라 모델 컨텍스트 프로토콜을 통해 AI 에이전트에 도구를 제공하는 서버입니다.