jkf87/weather-mcp

Weather MCP Server

한국 주요 도시의 날씨를 조회하는 MCP(Model Context Protocol) 서버입니다.

Open-Meteo API를 사용하여 무료로 날씨 정보를 제공합니다. API 키가 필요 없습니다.

지원 도시

서울, 부산, 인천, 대구, 대전, 광주, 울산, 제주

설치 방법

pip install git+https://github.com/jkf87/weather-mcp.git

MCP 클라이언트 설정

설정 파일 빠르게 열기

macOS에서 빠르게 열기

# 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에서 메모장으로 열기

notepad %USERPROFILE%\.gemini\settings.json

Claude Code

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)에 추가:

{
  "mcpServers": {
    "weather-server": {
      "command": "weather-mcp"
    }
  }
}

Gemini CLI

~/.gemini/settings.json에 추가:

{
  "mcpServers": {
    "weather-server": {
      "command": "weather-mcp"
    }
  }
}

Antigravity

~/.antigravity/mcp.json에 추가:

{
  "mcpServers": {
    "weather-server": {
      "command": "weather-mcp"
    }
  }
}

기타 MCP 클라이언트

대부분의 MCP 클라이언트에서 다음과 같이 설정할 수 있습니다:

{
  "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 어시스턴트에게 다음과 같이 요청할 수 있습니다:

• "서울 날씨 알려줘"
• "부산이랑 제주 날씨 비교해줘"
• "오늘 대전 날씨 어때?"

삭제 방법

패키지 삭제

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

직접 실행 (개발/테스트용)

# 서버 실행
weather-mcp

# 또는 Python 모듈로 실행
python -m weather_mcp.server

라이선스

MIT License