mcp-weather
🌤️ Kaushik의 날씨 MCP 서버
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 도구
도구 | 매개변수 | 설명 |
|
| 미국 좌표에 대한 실시간 기간별 예보(기온, 바람, 기상 상태)를 검색합니다. |
|
| 활성 악천후 경보, 주의보, 기상 특보를 가져옵니다. |
| 없음 | 런타임 상태, 가동 시간, 힙 메모리 사용량, 캐시 크기, API 연결 상태를 반환합니다. |
| 없음 | 성능 진단 및 활성 속도 제한 클라이언트 버킷을 출력합니다. |
| 없음 | 인메모리 캐시를 비우고 제거된 항목 수를 반환합니다. |
🚀 시작하기
1. 클론 및 설치
git clone https://github.com/Kaushik2105/mcp-weather.git
cd mcp-weather
npm install2. 빌드
npm run build3. 테스트 스위트 실행
npm test🔌 Claude Desktop에 연결하기
이 구성을 Claude Desktop 구성 파일에 추가하세요:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/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
GitHub: @Kaushik2105
라이브 연동 증명: Claude AI 채팅
This server cannot be installed
Maintenance
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
- FlicenseBqualityDmaintenanceProvides 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.21
- FlicenseNot gradedqualityDmaintenanceProvides real-time weather alerts and forecasts from the National Weather Service for US locations, integrating with AI assistants via the Model Control Protocol.
- FlicenseNot gradedqualityCmaintenanceProvides 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.
- FlicenseNot gradedqualityDmaintenanceProvides weather forecasts and alerts for US locations via the National Weather Service API, enabling AI assistants to deliver real-time weather information.26
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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