Skip to main content
Glama
Kaushik2105

mcp-weather

by Kaushik2105

🌤️ Kaushik의 날씨 MCP 서버

TypeScript Model Context Protocol Node.js Tests Claude Verified License: ISC

TypeScript로 구축된 프로덕션 준비 완료 Model Context Protocol (MCP) 서버로, LLM(Claude Desktop, Cursor, 맞춤형 AI 에이전트 등)을 National Weather Service(NWS / NOAA)의 실시간 기상 데이터에 연결합니다.


🔗 라이브 연동 증명

🚀 Claude Desktop과의 연동 검증 완료: 실시간 예보 조회, 알림, 상태 진단을 보여주는 라이브 채팅 세션을 확인하세요:
👉 라이브 Claude AI 채팅 증거 보기


Related MCP server: mcp-weather

✨ 아키텍처 하이라이트

  • 🏗️ 모듈식 클린 아키텍처: 전용 서비스 계층(CacheService, RateLimiterService, NwsClient, Logger, Formatter)으로 분리.

  • 📡 공식 기상 게시판: 표준화된 메타데이터와 제공자 정보를 포함한 구조화된 기상 보고서.

  • 인메모리 캐싱(5분 TTL): 스레드 안전 인메모리 캐시로 업스트림 API 트래픽을 최대 80% 절감.

  • 🛡️ Zero-Vibe 보안 계층: 엄격한 입력 검증, XSS 엔티티 이스케이프, 클라이언트 격리 속도 제한(분당 100회 요청).

  • 🔁 복원력 및 내결함성: HTTP 5xx / 429 오류에 대한 자동 지수 백오프 재시도 및 요청 시간 초과 가드.

  • 🩺 관측성 및 진단: 구조화된 JSON 로깅과 함께 제공되는 내장 health_check, get_metrics, clear_cache 도구.


📁 프로젝트 구조

weather/
├── src/
│   ├── config/          # Central configuration & runtime constants
│   ├── services/        # Core business logic (Cache, RateLimiter, NwsClient, Formatter, Logger)
│   ├── tools/           # MCP Tool handlers (alerts, forecast, diagnostics)
│   ├── types/           # Strongly typed TypeScript interfaces
│   ├── utils/           # Input sanitization and security helpers
│   └── index.ts         # Server bootstrap, transport initialization & graceful shutdown
├── tests/
│   ├── unit/            # Unit test suites (utils, sanitizer, cache)
│   ├── integration/     # Upstream NWS API integration & retry tests
│   ├── performance/     # Cache throughput & rate-limiting load tests
│   ├── security/        # XSS, injection prevention & boundary tests
│   └── basic.test.ts    # Comprehensive test runner
├── build/               # Compiled ES module JavaScript distribution
├── package.json
└── tsconfig.json

🛠️ MCP 도구

도구

매개변수

설명

get_forecast

latitude (숫자), longitude (숫자)

미국 좌표에 대한 실시간 기간별 예보(기온, 바람, 기상 상태)를 검색합니다.

get_alerts

state (2자리 미국 주 코드, 예: CA, NY, TX)

활성 악천후 경보, 주의보, 기상 특보를 가져옵니다.

health_check

없음

런타임 상태, 가동 시간, 힙 메모리 사용량, 캐시 크기, API 연결 상태를 반환합니다.

get_metrics

없음

성능 진단 및 활성 속도 제한 클라이언트 버킷을 출력합니다.

clear_cache

없음

인메모리 캐시를 비우고 제거된 항목 수를 반환합니다.


🚀 시작하기

1. 클론 및 설치

git clone https://github.com/Kaushik2105/mcp-weather.git
cd mcp-weather
npm install

2. 빌드

npm run build

3. 테스트 스위트 실행

npm test

🔌 Claude Desktop에 연결하기

이 구성을 Claude Desktop 구성 파일에 추가하세요:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kaushik-weather": {
      "command": "node",
      "args": [
        "c:/Workholic/LawSikho/POCs/weather/weather/build/index.js"
      ]
    }
  }
}

참고: 구성을 저장한 후 Claude Desktop을 다시 시작하세요.


💬 Claude용 샘플 프롬프트

  • "로스앤젤레스(위도: 34.0522, 경도: -118.2437)에 대한 Kaushik의 날씨 도구 공식 예보 게시판을 보여줘"

  • "플로리다(FL)에 활성 기상 경보가 있나요?"

  • "Kaushik의 날씨 MCP 서버에서 상태 점검 진단을 실행해."


👨💻 작성자

Kaushik Karmakar

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Provides real-time US weather alerts and forecasts by integrating with the National Weather Service API. It enables AI assistants to fetch state-specific alerts and detailed local forecasts using geographic coordinates.
    2
    1
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time weather alerts and forecasts from the National Weather Service for US locations, integrating with AI assistants via the Model Control Protocol.
  • F
    license
    Not graded
    quality
    C
    maintenance
    Provides real-time weather alerts and forecasts for US locations by integrating with the National Weather Service API. Supports both server and client interactions with optional LLM summarization.
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides weather forecasts and alerts for US locations via the National Weather Service API, enabling AI assistants to deliver real-time weather information.
    26

View all related MCP servers

Related MCP Connectors

  • US weather, alerts, earthquakes and elevation for AI agents, from NWS/NOAA and USGS. No API keys.

  • US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.

  • Get US weather forecasts, active alerts, and current observations.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kaushik2105/mcp-weather'

If you have feedback or need assistance with the MCP directory API, please join our Discord server