Weather MCP

🚀 Weather MCP 🌤️

Weather MCP 是一款基于多云平台（MCP）构建的现代天气服务，可提供实时天气数据和预警信息。

🚀 快速开始

前提条件

• Node.js（v18 或更高版本）
• MCP 服务器
• Git

安装步骤

1. 克隆仓库：

git clone https://github.com/gifflet/weather-mcp.git
cd weather-mcp

2. 安装依赖并构建项目：

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，查询仅适用于美国境内的位置。

高级用法

当你发起查询时，系统会按以下步骤处理：

1. 你的问题会被发送到大型语言模型（LLM）。
2. LLM 会分析可用的工具并决定使用哪些工具。
3. 客户端通过 MCP 服务器执行所选工具。
4. 结果会被发送回 LLM。
5. 系统会生成自然语言响应并展示给你。

常见问题排查

如果工具无法按预期工作，请按以下步骤操作：

• 验证服务器构建和运行是否没有错误。
• 检查 .cursor/mcp.json 中的路径是否正确且为绝对路径。
• 如有必要，重启 Cursor IDE。
• 由于该服务仅支持美国境内的位置，查询美国境外的坐标会收到错误信息。
• 在高流量期间，天气服务 API 可能会有速率限制。

🤝 贡献代码

欢迎贡献代码！请随时提交拉取请求。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。