MCP Weather

MCP 날씨 서버

AccuWeather API를 사용하여 시간별 및 일별 날씨 예보를 제공하는 MCP(Model Context Protocol) 서버입니다.

빠른 시작

AccuWeather API 키가 필요합니다(무료 계층 이용 가능).
여기에서 가입 하고 앱을 만들어서 열쇠를 받으세요.

API 키를 환경 변수로 내보내세요.

지엑스피1

그런 다음 다음을 사용하여 MCP 날씨 서버를 직접 실행합니다.

또는 supergateway를 통한 HTTP/REST 액세스의 경우:

MCP 서버 구성 예

Claude Desktop 또는 다른 MCP 호환 클라이언트와 통합하려면 다음을 구성에 추가하세요(예: claude_desktop_config.json ):

개요

이 MCP 서버를 사용하면 Claude와 같은 대규모 언어 모델이 실시간 날씨 데이터에 접근할 수 있습니다. LLM과 통합하면 모델은 다음과 같은 작업을 수행할 수 있습니다.

• 정확하고 최신의 날씨 예보를 가져옵니다
• 다음 12시간 동안의 시간별 날씨 데이터를 제공합니다.
• 최대 15일 동안의 일일 날씨 예보를 확인하세요
• 미터법(°C)과 영국식(°F) 단위로 데이터를 표시합니다.
• 온도, 기상 조건, 강수량 정보 및 기타 날씨 세부 정보를 확인하세요

필수 조건

• 노드.js ≥18
• AccuWeather API 키( .env 또는 셸을 통해 설정)

설정

1. 이 저장소를 복제하세요:
   git clone https://github.com/TimLukaHorstmann/mcp-weather.git cd mcp-weather
2. 종속성 설치:
   npm install
3. AccuWeather API 키 받기:
   • AccuWeather API 에 등록하세요
   • 새로운 앱을 만들고 API 키를 얻으세요
4. API 키로 .env 파일을 만듭니다.
   ACCUWEATHER_API_KEY=your_api_key_here
5. 프로젝트를 빌드하세요:
   npm run build

Claude Desktop과 함께 사용

1. 이 MCP 서버를 사용하도록 Claude Desktop을 구성하세요.
   • 클로드 데스크톱 열기
   • 설정 > 개발자 > 구성 편집으로 이동하세요.
   • claude_desktop_config.json 에 다음을 추가하세요.
   { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }
2. Claude Desktop을 다시 시작하세요
3. 새로운 대화에서 플러그 아이콘을 클릭하고 "날씨"를 선택하여 MCP 서버를 활성화합니다.
4. 이제 클로드에게 다음과 같은 날씨 예보를 물어볼 수 있습니다.
   • "뉴욕시의 시간별 날씨는 어떻습니까?"
   • "런던의 5일 날씨를 알려주세요."
   • "화씨로 이번 주 도쿄의 날씨는 어떨까요?"
   • "내일 샌프란시스코에 비가 올까요?"

사용 가능한 도구

시간별 날씨 예보

• 도구 이름: weather-get_hourly
• 다음 12시간 동안의 시간별 예보를 제공합니다.
• 매개변수:
  • sessionId (필수): 세션의 고유 식별자
  • location (필수): 도시 또는 위치 이름
  • units (선택 사항): "미터법"(섭씨, 기본값) 또는 "제국법"(화씨)

일일 날씨 예보

• 도구 이름: weather-get_daily
• 최대 15일 동안의 일일 예보를 제공합니다.
• 매개변수:
  • sessionId (필수): 세션의 고유 식별자
  • location (필수): 도시 또는 위치 이름
  • days (선택 사항): 예측 일수(1, 5, 10 또는 15, 기본값은 5)
  • units (선택 사항): "미터법"(섭씨, 기본값) 또는 "제국법"(화씨)

개발

• 개발 종속성 설치: npm install
• 코드를 린트하세요: npm run lint
• 빌드: npm run build
• 테스트 실행: npm test
• 개발 모드로 시작: npm run dev

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

향후 개선 사항

저희는 MCP 날씨 서버를 지속적으로 개선하기 위해 노력하고 있습니다. 향후 출시에 고려 중인 몇 가지 기능은 다음과 같습니다.

• 확장된 시간별 예보: 12시간 이상, 예를 들어 24시간 또는 48시간.
• 날씨 경보: AccuWeather의 심각한 날씨 경보 API와 통합되었습니다.
• 위치 자동완성: 자동완성 제안을 통해 위치 검색이 개선되었습니다.
• 과거 기상 데이터: 과거 기상 상황에 대한 접근.

다른 기능에 대한 아이디어가 있으시다면, 언제든지 이슈를 공개해주세요!

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.