한국 기상 MCP 서버
이 MCP(Multi-platform Communication Protocol) 서버는 한국 기상청(KMA) API에 대한 액세스를 제공하여 AI 에이전트가 한국 내 지역의 날씨 예보 정보를 검색할 수 있도록 합니다.
개요
- 한국 행정구역의 정확한 격자 좌표를 검색합니다.
- 한국 내 모든 지역의 자세한 단기 날씨 예보를 받아보세요
- 대한민국 모든 행정구역(시, 군, 구, 동) 지원
- LLM 소비에 최적화된 구조화된 텍스트 응답
- 온도, 강수량, 하늘 상태, 습도, 풍향, 풍속을 포함한 종합적인 날씨 데이터
목차
설정
필수 조건
- 파이썬 3.12+
- 기상청 API 인증 정보
- 공공데이터포털 에 가입하신 후 "기상청_단기예보 ((구)_동네예보) 조회서비스" API 접속을 요청하시면 API 자격 증명을 받으실 수 있습니다.
설치
- 저장소를 복제합니다.
지엑스피1
- 자외선 설치
curl -LsSf https://astral.sh/uv/install.sh | sh
- 가상 환경을 만들고 종속성을 설치합니다.
uv venv -p 3.12
source .venv/bin/activate
uv pip install -r requirements.txt
- KMA API 자격 증명으로
.env 파일을 만듭니다.
cp env.example .env
vi .env
KO_WEATHER_API_KEY=your_api_key_here
- Excel에서 SQLite로 그리드 좌표 데이터를 마이그레이션합니다.
Docker 사용하기
- Docker 이미지를 빌드합니다.
docker build -t py-mcp-ko-weather .
- 컨테이너를 실행합니다.
docker run py-mcp-ko-weather
로컬 사용
- 서버를 실행합니다:
MCP 설정 구성
MCP 설정 파일에 서버 구성을 추가합니다.
클로드 데스크톱 앱
- Smithery를 통해 자동으로 설치하려면:
npx -y @smithery/cli install @jikime/py-mcp-ko-weather --client claude
- 수동으로 설치하려면
~/Library/Application Support/Claude/claude_desktop_config.json 엽니다.
mcpServers 개체에 다음을 추가합니다.
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-ko-weather",
"run",
"src/server.py"
]
}
}
}
커서 IDE
~/.cursor/mcp.json 엽니다
mcpServers 개체에 다음을 추가합니다.
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-ko-weather",
"run",
"src/server.py"
]
}
}
}
도커를 위해
{
"mcpServers": {
"Google Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"py-mcp-ko-weather"
]
}
}
}
Claude와 함께 사용
구성이 완료되면 Claude에게 다음과 같은 질문을 할 수 있습니다.
- "서울특별시 서초구 양재1동의 날씨는요?"
- "부산광역시 해운대구 우동의 기상 예보를 알려드립니다"
- "경기도 성남시 분당구의 현재은?"
API 참조
도구
그리드 위치 가져오기
get_grid_location(city: str, gu: str, dong: str) -> dict
기상청 API에서 지정된 위치에 사용되는 격자 좌표(nx, ny)를 검색합니다. 이 도구는 시/도, 군/구, 동/읍 정보를 기반으로 데이터베이스에서 정확한 좌표를 검색합니다.
예보 받기
get_forecast(city: str, gu: str, dong: str, nx: int, ny: int) -> str
기상청의 초단기 예보 API를 호출하여 특정 지역의 기상 예보 정보를 제공합니다. 기온, 강수량, 하늘 상태, 습도, 풍향, 풍속을 포함한 종합적인 기상 데이터를 반환합니다.
자원
날씨 지침
GET http://localhost:8000/weather-instructions
도구 워크플로와 응답 형식을 포함하여 Korea Weather MCP 서버 사용 방법에 대한 자세한 설명서를 제공합니다.
프롬프트
날씨 쿼리
서버에는 날씨 질의에 대한 대화를 안내하고, 효율적인 정보 수집과 예보 데이터의 명확한 표현을 보장하기 위한 체계적인 프롬프트 템플릿이 포함되어 있습니다.
응답 형식
날씨 예보 응답은 LLM 처리에 최적화된 구조화된 텍스트 형식으로 제공됩니다.
Weather forecast for 서울특별시 서초구 양재1동 (coordinates: nx=61, ny=125)
Date: 2025-05-01
Time: 15:00
Current conditions:
Temperature: 22.3°C
Sky condition: Mostly clear
Precipitation type: None
Precipitation probability: 0%
Humidity: 45%
Wind direction: Northwest
Wind speed: 2.3 m/s
Hourly forecast:
16:00 - Temperature: 21.8°C, Sky: Clear, Precipitation: None
17:00 - Temperature: 20.5°C, Sky: Clear, Precipitation: None
18:00 - Temperature: 19.2°C, Sky: Clear, Precipitation: None
...
감사의 말
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.