Weather MCP 🌤️

Weather MCP 🌤️

基于 MCP（Multi-Cloud Platform）构建的现代天气服务，可提供实时天气数据和预警。

🌟 功能

• 🌡️ 实时天气预报
• ⚠️ 按州查看天气预警
• 📍 基于位置的天气信息
• 🔄 易于使用的 API 端点

🚀 快速开始

先决条件

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

安装

1. 克隆仓库：

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

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

npm install && npm run build

💻 使用 MCP 服务进行本地开发

配置 MCP 服务

1. 在项目目录中创建 .cursor/mcp.json 文件，内容如下：

{
  "mcpServers": {
    "weather-service": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js"],
    }
  }
}

其中，/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js 是 weather-mcp 项目的 build 文件夹中 index.js 文件的路径。

或者，如需全局配置，可在主目录根目录下创建文件：.cursor/mcp.json。

启动 MCP 服务

1. 在 Cursor IDE 中打开项目
2. 前往 Cursor Settings > Features > MCP
3. 你的天气服务应显示在可用 MCP 服务列表中
4. 如有需要，点击右上角的刷新按钮以加载工具列表

使用天气服务

在 Cursor 中配置并启动 MCP 服务后，你可以使用自然语言查询与天气服务交互。以下是一些示例：

示例查询

• “萨克拉门托的天气怎么样？”
• “德克萨斯州有正在生效的天气预警吗？”
• “旧金山的天气预报是什么？”
• “显示加利福尼亚州的天气预警”

注意：由于此服务使用美国国家气象局 API，查询仅适用于美国境内的位置。

底层工作原理

进行查询时：

1. 你的问题会发送给大模型
2. 大模型会分析可用工具，并决定使用哪些工具
3. 客户端通过 MCP 服务执行选定的工具
4. 结果会返回给大模型
5. 系统会生成自然语言回复并向你显示

常见问题排查

如果工具未按预期运行：

• 确认服务可以成功构建和运行，没有错误
• 检查 .cursor/mcp.json 中的路径是否正确且为绝对路径
• 如有需要，重启 Cursor IDE
• 对于美国境外的坐标，你会收到错误，因为此服务仅支持美国境内的位置
• 流量较高时，天气服务 API 可能会有速率限制

🤝 参与贡献

欢迎贡献！请随时提交 Pull Request。

📝 许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。