🚀 Weather MCP 🌤️
Weather MCP 是一款基于多云平台（MCP）构建的现代天气服务，可提供实时天气数据和预警信息。
🚀 快速开始
前提条件
- Node.js（v18 或更高版本）
- MCP 服务器
- Git
安装步骤
- 克隆仓库：
git clone https://github.com/gifflet/weather-mcp.git
cd weather-mcp
- 安装依赖并构建项目：
npm install && npm run build
✨ 主要特性
- 🌡️ 实时天气预报
- ⚠️ 按州发布的天气预警
- 📍 基于位置的天气信息
- 🔄 易于使用的 API 端点
💻 使用示例
基础用法
在 Cursor IDE 中配置并启动 MCP 服务器后，你可以使用自然语言查询与天气服务进行交互。以下是一些示例查询：
- "What's the weather in Sacramento?"（萨克拉门托的天气如何？）
- "Are there any active weather alerts in Texas?"（得克萨斯州有正在生效的天气预警吗？）
- "What's the forecast for San Francisco?"（旧金山的天气预报如何？）
- "Show me weather alerts for CA"（给我看看加利福尼亚州的天气预警）
注意：由于此服务使用美国国家气象局 API，查询仅适用于美国境内的位置。
高级用法
当你发起查询时，系统会按以下步骤处理：
- 你的问题会被发送到大型语言模型（LLM）。
- LLM 会分析可用的工具并决定使用哪些工具。
- 客户端通过 MCP 服务器执行所选工具。
- 结果会被发送回 LLM。
- 系统会生成自然语言响应并展示给你。
常见问题排查
如果工具无法按预期工作，请按以下步骤操作：
- 验证服务器构建和运行是否没有错误。
- 检查
.cursor/mcp.json中的路径是否正确且为绝对路径。 - 如有必要，重启 Cursor IDE。
- 由于该服务仅支持美国境内的位置，查询美国境外的坐标会收到错误信息。
- 在高流量期间，天气服务 API 可能会有速率限制。
🤝 贡献代码
欢迎贡献代码！请随时提交拉取请求。
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。