彩云天气 MCP 服务器

彩云天气 MCP 服务器

site icon
2025.03.31 2
TypeScript天气服务位置查询位置服务
彩云天气 MCP 服务器是基于彩云天气 API 的 Model Context Protocol (MCP) 服务器,提供丰富的天气数据查询功能。该服务能够获取实时天气数据、分钟级降水预报、小时级和每日天气预报,以及天气预警信息。支持通过经纬度或地址查询天气,并具备多语言支持和单位制选择功能。
View on GitHub

Overview

基本能力

产品定位

彩云天气 MCP 服务器是一个基于彩云天气 API 的天气数据查询服务,通过 MCP 协议提供丰富的天气信息。

核心功能

  • 实时天气数据:温度、湿度、风速、气压等
  • 分钟级降水预报:未来2小时的降水情况
  • 小时级天气预报:未来24小时或更长时间的天气预报
  • 每日天气预报:未来多天的天气预报
  • 天气预警信息:各类天气预警
  • 地址查询:支持通过地址查询天气(需配置高德地图API)
  • 多语言支持:支持中文和英文
  • 单位制选择:支持公制和英制

适用场景

  • 需要实时天气数据的应用
  • 需要精确降水预报的应用
  • 需要长期天气预报的应用
  • 需要天气预警信息的应用
  • 需要根据地址查询天气的应用

工具列表

  1. get_weather_by_location:根据经纬度获取天气信息
  2. get_weather_by_address:根据地址获取天气信息
  3. get_realtime_weather:获取实时天气数据
  4. get_minutely_forecast:获取分钟级降水预报
  5. get_hourly_forecast:获取小时级天气预报
  6. get_daily_forecast:获取每日天气预报
  7. get_weather_alert:获取天气预警信息

常见问题解答

  • 需要配置彩云天气API密钥才能使用
  • 地址查询功能需要额外配置高德地图API密钥
  • 支持中文和英文两种语言
  • 支持公制和英制两种单位制

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 确保 MCP SDK 在运行环境中可用

安装教程

  1. 克隆仓库:
git clone https://github.com/marcusbai/caiyun-weather-mcp.git
cd caiyun-weather-mcp
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build

配置

  1. 获取彩云天气API密钥
  2. (可选)获取高德地图API密钥
  3. 编辑MCP设置文件,添加彩云天气MCP服务器配置

调试方式

  1. 确保服务已正确配置
  2. 使用示例命令测试各项功能
  3. 检查返回的天气数据是否符合预期

许可证

该项目遵循 MIT 开源许可条款。