MCP 날씨 서버

FastMCP 기반의 날씨 조회 MCP 서버로, 현재 날씨, 향후 일기 예보, 섭씨/화씨 변환, 인기 도시 리소스 및 여행 날씨 조언 프롬프트를 제공합니다.

프로젝트에는 두 가지 실행 진입점이 포함되어 있습니다:

• server.py: 로컬 stdio 모드, Claude Desktop, Cursor, Cherry Studio 등 로컬 MCP 클라이언트에 적합합니다.

• server_remote.py: Streamable HTTP 모드, ModelScope 등 원격 호스팅 플랫폼에 배포하기에 적합합니다.

기능

• get_weather(city: str): 지정된 도시의 현재 날씨를 조회합니다.

• get_forecast(city: str, days: int = 3): 지정된 도시의 향후 일기 예보를 조회합니다(기본값 3일).

• temperature_convert(value: float, from_unit: str): 섭씨와 화씨를 상호 변환합니다.

• weather://cities: 자주 사용하는 도시 목록 리소스를 반환합니다.

• travel_advisor(destination: str, date: str): 여행 날씨 조언 프롬프트를 생성합니다.

날씨 데이터는 wttr.in에서 가져오며, 별도의 API 토큰이 필요하지 않습니다.

환경 요구 사항

• Python >= 3.12

• uv를 사용하여 의존성을 관리하는 것을 권장합니다.

의존성 설치

uv sync

uv를 사용하지 않는 경우, 가상 환경에서 의존성을 설치할 수도 있습니다:

pip install "mcp[cli]>=1.27.0" "httpx>=0.28.1"

로컬 실행

stdio 모드:

uv run python server.py

MCP 클라이언트 구성 예시:

{
  "mcpServers": {
    "weather-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"]
    }
  }
}

원격 실행

Streamable HTTP 모드:

uv run python server_remote.py

기본 리스닝:

http://0.0.0.0:8000/mcp/

원격 MCP 클라이언트 구성 예시:

{
  "mcpServers": {
    "weather-server": {
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

ModelScope 배포 설명

ModelScope에서 MCP 서버를 생성하거나 배포할 때, 본 프로젝트의 GitHub 저장소 주소를 입력하고 원격 진입점 파일을 사용하십시오:

python server_remote.py

서비스는 Streamable HTTP 방식으로 시작되며 0.0.0.0:8000을 리스닝합니다. MCP 엔드포인트는 다음과 같습니다:

/mcp/

플랫폼이 사용자 지정 시작 명령을 지원하는 경우 다음을 권장합니다:

uv run python server_remote.py

또는 플랫폼 환경에서 의존성을 미리 설치한 후 사용하십시오:

python server_remote.py

프로젝트 구조

.
├── README.md
├── pyproject.toml
├── server.py
├── server_remote.py
└── uv.lock

라이선스

오픈 소스로 배포해야 하는 경우, 실제 상황에 맞게 라이선스 파일을 추가하십시오.