项目简介

'qweather-mcp' 是一个基于 Model Context Protocol (MCP) 实现的服务器端程序，旨在为支持 MCP 的 LLM 客户端（如某些AI聊天助手）提供访问和风天气 (QWeather) API 的能力。它将和风天气的查询功能封装成 MCP 工具，使 LLM 能够通过标准的协议调用这些功能，获取实时的天气和地理位置信息。

主要功能点

该 MCP 服务器提供了以下核心功能：

查询城市信息: 根据城市名称查找详细的城市信息，包括城市ID、经纬度等，这是获取天气数据的前提。
获取当前天气: 根据城市ID（通常通过“查询城市信息”获取）获取指定地点的实时天气状况，包括温度、湿度、风力、天气描述等。

安装步骤

作为 MCP 服务器，'qweather-mcp' 通常由 MCP 客户端自动启动和管理。用户无需手动运行复杂的安装命令。客户端会根据配置找到并启动 'qweather-mcp' 程序。

如果需要独立安装或了解其运行方式，可以通过 npm 全局安装：

npm install -g qweather-mcp

或者在项目中通过 npx 运行：

npx qweather-mcp

服务器配置

要让您的 MCP 客户端使用此服务，您需要在客户端的配置中添加一个 MCP 服务器入口。配置通常是 JSON 格式，指定如何启动 'qweather-mcp' 程序并为其提供必要的 API 密钥。

您需要先访问和风天气官网注册账号并获取您的 API Key。

典型的 MCP 客户端配置示例（具体配置方式请参考您的客户端文档）：

{
  "mcpServers": {
    "qweather": { // 给服务器起一个内部名称，客户端用来区分
      "command": "npx", // 启动程序的命令，这里使用 npx
      "args": ["qweather-mcp"], // 传递给命令的参数
      "env": { // 环境变量，用于传递 API 密钥等配置
        "QWEATHER_API_BASE": "https://api.qweather.com", // 和风天气 API 地址，通常使用默认值
        "QWEATHER_API_KEY": "<您的和风天气 API Key>" // !!! 替换为您自己在和风天气开放平台申请的有效 API Key
      }
    }
  }
}

请务必将 '<您的和风天气 API Key>' 替换为您自己在和风天气开放平台申请的有效 API Key。'QWEATHER_API_BASE' 如果使用和风天气默认的公共 API 地址，通常不需要修改。

基本使用方法

配置完成后，启动支持 MCP 的 LLM 客户端。客户端会检测到 'qweather-mcp' 服务器及其提供的工具能力。当您与 LLM 交流时，如果对话内容涉及天气查询或城市信息，LLM 可能会自动调用此 MCP 服务器提供的工具来获取所需信息，并将结果整合到回复中。用户无需直接与 MCP 服务器交互，所有调用由 LLM 客户端根据对话上下文决策并执行。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息