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 密钥创建一个

   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文件。