Weather Alerts & Forecast

Weather MCP 服务

一个 MCP 服务，提供：

• 按美国两字母州代码查询有效的美国国家气象局（NWS）预警
• 经纬度坐标的短期点预测（接下来 5 个时段）

数据来自 NWS 公共 API：https://api.weather.gov。

工具

工具	描述	输入
get_alerts	获取美国某州的有效 NWS 预警	state（字符串，两字母代码）
get_forecast	获取指定坐标的短期预测（接下来 5 个时段）	latitude（数字）、longitude（数字）

使用方法（本地）

安装依赖：

pip install .

运行 MCP 服务（stdio 传输）：

python -m weather.weather

MCP 客户端应配置为通过软件包入口点或上述模块路径启动服务。

服务 JSON 摘要

请参阅 server.json，了解包括名称、版本、工具和入口点配置在内的注册元数据。

发布步骤（概览）

1. 使用发布者身份验证（GitHub 命名空间）：

   mcp-publisher login github
   

2. 在 GitHub 上创建并推送仓库（参见以下步骤）。
3. （可选）如果要作为软件包分发，可发布到 PyPI。
4. 发布到 MCP 注册表：

   mcp-publisher publish
   

5. 验证：

   curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vtiwari/weather-mcp"
   

创建并推送 GitHub 仓库

如果此目录尚未是 Git 仓库：

git init
git add .
git commit -m "Initial commit: Weather MCP server"

创建仓库（GitHub CLI）并推送：

gh repo create vtiwari/weather-mcp --public --source . --remote origin --push

如果不使用 GitHub CLI，可通过 GitHub 网页界面手动创建仓库，然后：

git remote add origin https://github.com/vtiwari/weather-mcp.git
git branch -M main
git push -u origin main

为保持版本一致性，为发布版本创建标签：

git tag v0.1.0
git push origin v0.1.0

PyPI 打包（可选）

要通过 PyPI 分发，请确保 pyproject.toml 包含构建后端和元数据（作者、许可证）。然后：

pip install build twine
python -m build
twine upload dist/*

许可证

MIT（如不同，请相应调整）。

免责声明

此服务使用 NOAA/NWS 公共端点。请遵守 API 使用指南和速率限制。