mcpapp1 — 날씨 MCP 서버

Claude Desktop, Claude Code, Cursor 같은 MCP 클라이언트에 미국 실시간 기상 특보를 제공하는 작은 Model Context Protocol 서버입니다.

데이터는 National Weather Service API에서 가져오며, 무료이고 API 키가 필요 없습니다.

제공 기능

Related MCP server: Weather Alert & Forecast MCP Tool

요구 사항

• Python 3.13+

• uv

설치

git clone https://github.com/eyosiasbisrat/mcpapp1.git
cd mcpapp1
uv sync

실행

stdio로 서버를 직접 실행하려면:

uv run server/weather.py

또는 MCP CLI를 통해:

uv run mcp run server/weather.py

MCP Inspector에서 대화형으로 검사하려면:

uv run mcp dev server/weather.py

MCP 서버는 stdin/stdout으로 JSON-RPC를 주고받으므로, 직접 실행하면 입력을 조용히 기다릴 뿐입니다. 이는 정상적인 동작입니다. 보통은 클라이언트가 서버를 대신 실행합니다.

클라이언트 연결

Claude Code / Cursor

두 설정 파일은 이미 커밋되어 있고 상대 경로를 사용하므로, uv sync 후 수정 없이 바로 동작합니다:

• .mcp.json — Claude Code

• .cursor/mcp.json — Cursor

편집기 창을 새로고침하고, 프롬프트가 표시되면 서버를 승인하세요.

Claude Desktop

uv run mcp install server/weather.py

그런 다음 Claude Desktop을 완전히 종료하세요. 창을 닫아도 트레이 아이콘으로 계속 실행되므로 트레이 아이콘까지 종료해야 합니다. 그런 다음 다시 실행하세요.

Claude Desktop이 분명히 설치되어 있는데 Claude app not found가 출력되면 아래를 참고하세요.

문제 해결

Windows에서 Claude app not found

mcp install은 고정된 위치에서 Claude Desktop의 설정을 찾습니다:

%APPDATA%\Claude

Claude Desktop이 MSIX / Microsoft Store 패키지로 설치된 경우, 데이터가 패키지 컨테이너로 리디렉션되어 해당 디렉터리는 존재하지 않습니다:

%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json

해결 방법은 두 가지입니다.

실제 설정을 직접 편집 — 위의 패키지 경로에 있는 claude_desktop_config.json에 mcpServers 항목을 추가하되, 기존 키는 그대로 유지하세요.

또는 디렉터리 정션(junction)으로 경로를 한 번 연결하면 이후 모든 서버에서 mcp install이 정상적으로 동작합니다:

cmd /c mklink /J "%APPDATA%\Claude" "%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude"

Claude_<id> 자리에 실제 패키지 폴더 이름을 넣으세요. 되돌리려면 cmd /c rmdir "%APPDATA%\Claude"를 실행하면 설정이 아닌 링크만 제거됩니다.

Windows에서 서버를 수동으로 등록할 때는 uv의 절대 경로를 사용하세요 (예: C:\Users\<you>\.local\bin\uv.exe). 패키지형 앱은 셸 PATH를 안정적으로 상속받지 못하므로, uv만 단독으로 쓰면 실행에 실패할 수 있습니다.

서버가 실제로 로드되었는지 확인

프로세스의 부모 관계를 확인하여 클라이언트가 서버를 실행했는지 확인하세요:

Get-CimInstance Win32_Process -Filter "Name='uv.exe'" | ForEach-Object {
  $p = Get-CimInstance Win32_Process -Filter "ProcessId=$($_.ParentProcessId)"
  "$($_.ProcessId) <- $($p.Name)"
}

부모가 Claude.exe인 uv.exe가 보이면 서버가 실행 중이라는 뜻입니다. 일부 Claude Desktop 빌드는 logs\에 서버별 로그를 남기지 않으므로, 로그 폴더가 비어 있어도 실패를 의미하지는 않습니다.

프로젝트 구조

server/weather.py     the MCP server: tool, resource, and NWS client
main.py               placeholder entrypoint
.mcp.json             Claude Code server config
.cursor/mcp.json      Cursor server config
pyproject.toml        dependencies (httpx, mcp[cli])

참고 사항

• get_alerts는 미국 기관인 NWS 특성상 미국 주만 지원합니다.

• 요청에는 NWS API가 요구하는 User-Agent 헤더가 포함됩니다.

• 네트워크 및 HTTP 오류는 무시되고, 트레이스백 대신 친절한 "가져올 수 없음" 메시지로 표시됩니다.