关键词

天气空气质量气象预报天气预警天文信息

项目简介

KnowAir 彩云天气MCP服务器是一个基于Model Context Protocol (MCP) 实现的应用后端，它通过标准化接口向大型语言模型 (LLM) 客户端（如Claude Desktop）提供丰富的气象数据和功能。该服务器集成了彩云天气API，提供包括实时天气、多日预报、小时级预报、分钟级降水、空气质量监测及预报、天气预警和天文信息等全面服务，并支持中文本地化和智能格式化。

主要功能点

  • 实时天气数据：获取当前地点的温度、湿度、风速、能见度等详细气象信息。
  • 全方位空气质量：提供PM2.5、PM10、O3、AQI等空气污染物数据及健康建议，支持监测站增强型预报。
  • 多维度天气预报：支持未来1-360小时逐小时预报及未来1-15天逐日预报，满足短期和长期规划需求。
  • 分钟级降水预报：针对中国主要城市，提供未来2小时逐分钟的降水强度预测。
  • 天气预警系统：实时推送当前生效的天气预警信息，助您及时应对。
  • 天文信息查询：查询日出日落、月出月落、月相信息。
  • 历史天气查询：可查询过去72小时内的历史天气数据。
  • 智能本地化：所有天气现象和生活指数均提供清晰的中文描述。

安装步骤

在本地计算机上运行此MCP服务器，您需要Python环境和彩云天气API密钥。

  1. 获取彩云天气API密钥： 访问 彩云天气API文档 申请您的API密钥。

  2. 安装 'uv' 包管理器： 'uv' 是一个快速的Python包管理器。

    • MacOS/Linux 用户： 
      curl -LsSf https://astral.sh/uv/install.sh | sh
    • Windows 用户： 
      powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

服务器配置（供MCP客户端使用）

MCP客户端（如Claude Desktop）需要配置此服务器的启动信息，以便与之通信。请将以下配置添加到您的MCP客户端配置文件（例如 'claude_desktop_config.json'）中。

{
  "mcpServers": {
    "knowair-weather": {
      "command": "uvx",
      "args": ["mcp-knowair-weather"],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

配置项说明：

  • '"knowair-weather"'：这是您为该MCP服务器定义的名称，客户端将使用此名称来识别和调用服务器。
  • '"command": "uvx"'：指定启动服务器的命令，'uvx' 是 'uv' 包管理器中用于执行已安装包可执行文件的工具。
  • '"args": ["mcp-knowair-weather"]'：传递给 'uvx' 命令的参数，'mcp-knowair-weather' 是此MCP服务器的入口点。
  • '"env": {"CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"}'：环境变量配置。请务必将 'YOUR_API_KEY_HERE' 替换为您在步骤1中获得的彩云天气API密钥。服务器将通过此环境变量获取API密钥以进行数据请求。

基本使用方法

配置完成后，您可以通过MCP客户端（例如Claude Desktop）直接向LLM提问，LLM将自动识别并调用此MCP服务器提供的天气工具。

示例：

  • 实时天气查询： 您：“北京现在的天气怎么样？” LLM（调用KnowAir Weather MCP服务器）：“北京实时天气数据：温度28°C，天气多云（白天），空气质量良...”

  • 空气质量预报分析： 您：“上海接下来一周的空气质量怎么样？” LLM（调用KnowAir Weather MCP服务器）：“上海空气质量预报（未来7天）：平均AQI 40，PM2.5呈下降趋势...”

  • 综合天气查询： 您：“使用综合接口查询广州未来3天+24小时天气预报。” LLM（调用KnowAir Weather MCP服务器）：“广州综合天气报告：实时温度30°C，未来3天多云转小雨，未来24小时逐小时预报及日出日落信息...”

信息

分类

网页与API

访问项目