使用说明

项目简介

HeFeng Weather MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它利用和风天气的 API 接口，为大型语言模型（LLM）应用提供中国城市的天气预报服务。通过此服务器，LLM 可以获取实时的、小时级的以及未来多天的天气预报信息，从而在对话或应用中融入天气相关的上下文信息。

主要功能点

实时天气查询: 获取指定地点的当前实时天气状况。
小时级天气预报: 提供未来 24 小时、72 小时或 168 小时（即1天、3天或7天）的逐小时天气预报。
多天天气预报: 提供未来 3 天、7 天、10 天、15 天或 30 天的每日天气预报。
经纬度定位: 支持通过经纬度坐标查询天气，精确定位到具体位置。
中文天气描述: 返回完整且易懂的中文天气描述信息。

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node Package Manager)。你可以从 nodejs.org 下载并安装。
获取 API 密钥: 你需要注册和风天气开发者账号，并获取你的 API 密钥。访问 dev.qweather.com 注册并创建应用，获取 API 密钥 (Key)。请注意，免费版的API有调用次数限制。

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 HeFeng Weather MCP Server，你需要配置客户端的配置文件。以 'claude_desktop_config.json' 为例，你需要添加如下 'mcpServers' 配置：

{
  "mcpServers": {
    "hefeng-weather": {
      "command": "npx",
      "args": ["hefeng-mcp-weather@latest", "--apiKey=YOUR_API_KEY"]
    }
  }
}

配置参数说明:

'"hefeng-weather"': 服务器名称，可以自定义，用于在 MCP 客户端中标识和引用此服务器。
'"command": "npx"': 指定启动服务器的命令为 'npx'，它会自动查找并执行 'hefeng-mcp-weather' 包。
'"args": [...]': 启动参数数组，包含以下内容：
- '"hefeng-mcp-weather@latest"': 指定要运行的 npm 包为 'hefeng-mcp-weather@latest'，'@latest' 表示使用最新版本。
- '"--apiKey=YOUR_API_KEY"': 你需要将 'YOUR_API_KEY' 替换为你从和风天气获取的 API 密钥。 这个参数用于将 API 密钥传递给服务器，让服务器能够调用和风天气 API。

请务必将 'YOUR_API_KEY' 替换为你自己的 API 密钥。

基本使用方法

配置完成后，当 MCP 客户端需要天气信息时，它可以通过调用 'get-weather' 工具来与 HeFeng Weather MCP Server 交互。

例如，在 Claude Desktop 中，你可以指示 Claude 使用 'get-weather' 工具来查询天气。你可以这样提问：

今天北京天气怎么样？

或者更精确地指定地点（使用经纬度，例如北京天安门）：

请使用 get-weather 工具查询 116.397,39.909 现在的天气

工具 'get-weather' 接受以下参数：

'location': 地点信息，可以是城市名称（可能需要英文，取决于和风天气API支持）或经纬度坐标（例如 "116.40,39.90"）。推荐使用经纬度以获得更准确的结果。
'days': 预报天数，可选值包括：
- '"now"': 实时天气 (默认值)
- '"24h"', '"72h"', '"168h"': 24小时、72小时、168小时逐小时预报
- '"3d"', '"7d"', '"10d"', '"15d"', '"30d"': 3天、7天、10天、15天、30天每日预报

例如，查询未来3天的北京天气预报，可以这样指示 Claude：

请使用 get-weather 工具查询北京未来3天的天气，参数 location=北京, days=3d

服务器会将天气预报信息返回给 MCP 客户端，然后客户端会将信息呈现给你。

注意:

首次运行 'npx hefeng-mcp-weather@latest' 可能会需要一些时间下载依赖包。
请确保你的 API 密钥配置正确，否则服务器将无法正常工作。
和风天气 API 可能有访问频率限制，请合理使用。

关键词