mcpapp1
mcpapp1 — 날씨 MCP 서버
Claude Desktop, Claude Code, Cursor 같은 MCP 클라이언트에 미국 실시간 기상 특보를 제공하는 작은 Model Context Protocol 서버입니다.
데이터는 National Weather Service API에서 가져오며, 무료이고 API 키가 필요 없습니다.
제공 기능
종류 | 이름 | 설명 |
도구 |
| 미국 주의 현재 발효 중인 기상 특보. 두 글자 코드로 지정 (예: |
리소스 |
| 메시지를 그대로 돌려줍니다. 서버에 연결할 수 있는지 확인하는 데 유용 |
Related MCP server: Weather MCP Server
요구 사항
Python 3.13+
설치
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.pyMCP Inspector에서 대화형으로 검사하려면:
uv run mcp dev server/weather.pyMCP 서버는 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%\ClaudeClaude 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 오류는 무시되고, 트레이스백 대신 친절한 "가져올 수 없음" 메시지로 표시됩니다.
Available Tools
1 toolget_alertsA
Get weather alerts for a US state.
Args: state: Two-letter US state code (e.g. CA, NY)
Inputs: state (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or misselection. The tool's purpose is clearly defined in its name and description.
The single tool name follows the verb_noun pattern (get_alerts), which is clean and predictable. There are no other tools to create inconsistency.
One tool feels thin for a server, even one dedicated to weather alerts. While alerts retrieval is a focused task, a small set of supporting tools (e.g., list states or get alert details) would make the server feel more complete.
For the stated purpose of retrieving weather alerts, the get_alerts tool covers the core operation without obvious gaps. The domain is narrow, and no additional lifecycle operations are necessary for read-only alert access.
Maintenance
Related MCP Connectors
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Get US weather forecasts, active and recent alerts, and current observations.
NOAA and ECMWF weather forecast MCP for discovery, validation, and GribStream OAuth queries.
US weather alerts (NWS): warnings, watches. $0.01/query. Be born in one call — free testnet funds.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceThis is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API. Features Get weather alerts for a US state Get weather forecast for a specific location (using latitude and longitude)-
- FlicenseNot gradedqualityDmaintenanceEnables users to get real-time weather alerts for US states and echo messages through both MCP server tools and a modern web interface. Provides weather information access with multiple deployment options for different use cases.1-
- AlicenseBqualityDmaintenanceProvides weather forecasts and alerts for US locations using the National Weather Service API. Enables users to retrieve active alerts by state and detailed forecasts by coordinates via MCP tools.122ISC
- FlicenseNot gradedqualityDmaintenanceEnables querying live U.S. National Weather Service alerts by state through MCP, with both Python and TypeScript implementations.-