MCP Weather

MCP 天气服务器

模型上下文协议 (MCP) 服务器使用 AccuWeather API 提供每小时和每日天气预报。

快速入门

您需要一个 AccuWeather API 密钥（提供免费套餐）。
在此注册并创建一个应用程序来获取您的密钥。

将您的 API 密钥导出为环境变量：

然后直接运行 MCP Weather 服务器：

或者，通过超级网关进行 HTTP/REST 访问：

MCP 服务器配置示例

为了与 Claude Desktop 或其他 MCP 兼容客户端集成，请将其添加到您的配置中（例如claude_desktop_config.json ）：

概述

该 MCP 服务器允许大型语言模型（例如 Claude）访问实时天气数据。与 LLM 集成后，该服务器可使模型实现以下功能：

• 获取准确、最新的天气预报
• 提供未来 12 小时每小时的天气数据
• 获取长达 15 天的每日天气预报
• 以公制（°C）和英制（°F）单位显示数据
• 查看温度、天气状况、降水信息和其他天气详情

先决条件

• Node.js ≥18
• AccuWeather API 密钥（通过.env或您的 shell 设置）

设置

1. 克隆此存储库：
   git clone https://github.com/TimLukaHorstmann/mcp-weather.git cd mcp-weather
2. 安装依赖项：
   npm install
3. 获取 AccuWeather API 密钥：
   • 在AccuWeather API注册
   • 创建新应用并获取 API 密钥
4. 使用您的 API 密钥创建一个.env文件：
   ACCUWEATHER_API_KEY=your_api_key_here
5. 构建项目：
   npm run build

与 Claude Desktop 一起使用

1. 配置 Claude Desktop 以使用此 MCP 服务器：
   • 打开 Claude 桌面
   • 前往“设置”>“开发者”>“编辑配置”
   • 将以下内容添加到您的claude_desktop_config.json中：
   { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }
2. 重启Claude桌面
3. 在新对话中，单击插头图标并选择“天气”以启用 MCP 服务器
4. 现在你可以向克劳德询问天气预报，例如：
   • “纽约市每小时的天气预报是什么？”
   • “请告诉我伦敦未来五天的天气预报。”
   • “本周东京的天气是华氏多少度？”
   • “明天旧金山会下雨吗？”

可用工具

每小时天气预报

• 工具名称： weather-get_hourly
• 提供未来 12 小时的每小时预报
• 参数：
  • sessionId （必需）：会话的唯一标识符
  • location （必填）：城市或地点名称
  • units （可选）：“公制”（摄氏度，默认）或“英制”（华氏度）

每日天气预报

• 工具名称： weather-get_daily
• 提供长达 15 天的每日预报
• 参数：
  • sessionId （必需）：会话的唯一标识符
  • location （必填）：城市或地点名称
  • days （可选）：预测天数（1、5、10 或 15；默认为 5）
  • units （可选）：“公制”（摄氏度，默认）或“英制”（华氏度）

发展

• 安装开发依赖项： npm install
• 检查你的代码： npm run lint
• 构建： npm run build
• 运行测试： npm test
• 以开发模式启动： npm run dev

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

未来的增强功能

我们始终致力于改进 MCP 天气服务器。以下是我们计划在未来版本中推出的一些功能：

• **延长每小时预报：**超过 12 小时，例如 24 或 48 小时。
• **天气警报：**与 AccuWeather 的恶劣天气警报 API 集成。
• **位置自动完成：**通过自动完成建议改进位置搜索。
• **历史天气数据：**了解过去的天气状况。

如果您对其他功能有想法，请随时提出问题！

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。