mcpapp1 — Weather MCP Server

一个小型 Model Context Protocol 服务器，向 MCP 客户端（如 Claude Desktop、Claude Code 和 Cursor）提供实时美国天气警报。

数据来自 National Weather Service API，该 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 条目，并保留所有现有键不变。

或者使用目录联接一次性桥接路径，之后 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）。打包应用无法可靠地继承你的 shell PATH，因此单独的 uv 可能无法启动。

验证服务器是否确实已加载

通过检查进程的父进程来确认客户端已启动它：

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

如果 uv.exe 的父进程是 Claude.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 是美国机构。

• 请求会携带 User-Agent 头，这是 NWS API 所要求的。

• 网络和 HTTP 错误会被吞掉，并以友好的“unable to fetch”消息呈现，而不是堆栈跟踪。