关键词

天气预报实时天气天气预警彩云天气LBS服务

使用说明

项目简介

彩云天气 MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，旨在为大型语言模型 (LLM) 客户端提供天气信息服务。通过集成彩云天气 API，该服务器提供了一系列工具，允许 LLM 查询实时天气、小时/天预报、历史天气以及天气预警信息。

主要功能点

  • 实时天气查询: 获取指定经纬度位置的实时天气数据，包括温度、湿度、风力、降水、空气质量等详细信息。
  • 小时/天预报: 提供未来72小时的逐小时天气预报和未来7天的逐日天气预报，包含温度、天气状况、降水概率等。
  • 历史天气查询: 查询过去24小时的天气数据。
  • 天气预警: 获取指定位置当前生效的天气预警信息。

安装步骤

  1. 安装 uv: 根据您的操作系统（MacOS/Linux 或 Windows），运行以下命令安装 '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"

  2. 获取彩云天气 API Token: 访问 https://docs.caiyunapp.com/weather-api/ 申请并获取您的彩云天气 API Token。

  3. 配置环境变量: 设置名为 'CAIYUN_WEATHER_API_TOKEN' 的环境变量，并将您获取的 API Token 值填入。

服务器配置

对于 MCP 客户端（例如 Claude Desktop），您需要配置服务器连接信息。以下是 'claude_desktop_config.json' 的配置示例，用于连接到彩云天气 MCP 服务器。

{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uvx",
      "args": ["mcp-caiyun-weather"],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"  // 请替换为您的彩云天气 API Token
      }
    }
  }
}

配置参数说明:

  • 'server name': 'caiyun-weather' (服务器名称，客户端用以识别和调用)
  • 'command': 'uvx' (启动服务器的命令，这里使用 'uvx' 运行 'mcp-caiyun-weather' 应用)
  • 'args': '["mcp-caiyun-weather"]' (传递给命令的参数，指定运行 'mcp-caiyun-weather' 应用)
  • 'env': '{"CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"}' (环境变量配置，请务必将 '"YOUR_API_KEY_HERE"' 替换为您申请的彩云天气 API Token)

注意: 请根据您的实际环境配置 'command' 和 'args'。如果本地开发调试，可以参考 README 中的 "Local/Dev Setup Instructions" 配置。

基本使用方法

配置完成后，在 MCP 客户端中，您可以向 LLM 提出需要天气信息的问题，例如：

  • "What's the weather in Beijing now?" (北京现在天气怎么样？)
  • "What will the weather be like in Shanghai tomorrow?" (上海明天天气如何？)
  • "Any weather alerts for London?" (伦敦有天气预警吗？)

LLM 客户端将自动调用彩云天气 MCP 服务器提供的工具来获取天气信息，并将其整合到回复中。

信息

分类

网页与API

访问项目