# Weather MCP Server
한국 주요 도시의 날씨를 조회하는 MCP(Model Context Protocol) 서버입니다.
[Open-Meteo API](https://open-meteo.com/)를 사용하여 **무료**로 날씨 정보를 제공합니다. API 키가 필요 없습니다.
## 지원 도시
서울, 부산, 인천, 대구, 대전, 광주, 울산, 제주
## 설치 방법
```bash
pip install git+https://github.com/jkf87/weather-mcp.git
```
## MCP 클라이언트 설정
### 설정 파일 빠르게 열기
| 클라이언트 | macOS | Windows |
|-----------|-------|---------|
| **Gemini CLI** | `~/.gemini/settings.json` | `%USERPROFILE%\.gemini\settings.json` |
| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` | `%APPDATA%\Claude\claude_desktop_config.json` |
| **Antigravity** | `~/.antigravity/mcp.json` | `%USERPROFILE%\.antigravity\mcp.json` |
#### macOS에서 빠르게 열기
```bash
# Gemini CLI
open ~/.gemini/settings.json
# Claude Desktop
open ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Antigravity
open ~/.antigravity/mcp.json
# 또는 VS Code로 열기
code ~/.gemini/settings.json
```
**Finder에서 열기**: `Cmd + Shift + G` → 경로 붙여넣기
#### Windows에서 빠르게 열기
**방법 1**: `Win + R` 누르고 아래 경로를 그대로 복사해서 붙여넣기
```
# Gemini CLI
%USERPROFILE%\.gemini
# Claude Desktop
%APPDATA%\Claude
# Antigravity
%USERPROFILE%\.antigravity
```
> `%USERPROFILE%`, `%APPDATA%`는 그대로 복사해서 붙여넣으세요. Windows가 자동으로 `C:\Users\사용자이름\...` 경로로 변환합니다.
**방법 2**: PowerShell/CMD에서 메모장으로 열기
```powershell
notepad %USERPROFILE%\.gemini\settings.json
```
---
### Claude Code
```bash
claude mcp add weather-server -- weather-mcp
```
### Claude Desktop
`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 또는
`%APPDATA%\Claude\claude_desktop_config.json` (Windows)에 추가:
```json
{
"mcpServers": {
"weather-server": {
"command": "weather-mcp"
}
}
}
```
### Gemini CLI
`~/.gemini/settings.json`에 추가:
```json
{
"mcpServers": {
"weather-server": {
"command": "weather-mcp"
}
}
}
```
### Antigravity
`~/.antigravity/mcp.json`에 추가:
```json
{
"mcpServers": {
"weather-server": {
"command": "weather-mcp"
}
}
}
```
### 기타 MCP 클라이언트
대부분의 MCP 클라이언트에서 다음과 같이 설정할 수 있습니다:
```json
{
"mcpServers": {
"weather-server": {
"command": "weather-mcp"
}
}
}
```
## 제공 도구 (Tools)
### `get_weather`
특정 도시의 현재 날씨 정보를 조회합니다.
**매개변수:**
- `city` (string): 도시 이름 (기본값: "서울")
**예시 응답:**
```
서울 날씨 정보
━━━━━━━━━━━━━━━━━━━━
온도: 15.2°C
습도: 65%
풍속: 12.5 km/h
날씨: 맑음
━━━━━━━━━━━━━━━━━━━━
조회 시간: 2024-11-30 14:30:00
```
### `list_cities`
사용 가능한 도시 목록을 반환합니다.
## 사용 예시
AI 어시스턴트에게 다음과 같이 요청할 수 있습니다:
- "서울 날씨 알려줘"
- "부산이랑 제주 날씨 비교해줘"
- "오늘 대전 날씨 어때?"
## 삭제 방법
### 패키지 삭제
```bash
pip uninstall weather-mcp
```
### MCP 설정 제거
각 클라이언트의 설정 파일에서 `weather-server` 항목을 삭제하세요:
- **Claude Code**: `claude mcp remove weather-server`
- **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Gemini CLI**: `~/.gemini/settings.json`
- **Antigravity**: `~/.antigravity/mcp.json`
## 직접 실행 (개발/테스트용)
```bash
# 서버 실행
weather-mcp
# 또는 Python 모듈로 실행
python -m weather_mcp.server
```
## 라이선스
MIT License
