JinDaGe - Caiyun Weather MCP Details

article

README

🚀 彩云天气 MCP 服务器

彩云天气 MCP 服务器基于彩云天气 API，遵循 Model Context Protocol (MCP)，为用户提供全面且精准的天气数据查询服务。

🚀 快速开始

彩云天气 MCP 服务器能为你提供丰富的天气数据。使用前，你需完成安装和配置步骤。

✨ 主要特性

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

📦 安装指南

克隆仓库：

git clone https://github.com/marcusbai/caiyun-weather-mcp.git
cd caiyun-weather-mcp

安装依赖：

npm install

⚠️ 重要提示

本项目依赖于 Model Context Protocol (MCP) SDK，该SDK需要在运行环境中可用。MCP SDK通常由Claude或其他支持MCP的应用程序提供。

构建项目：

npm run build

📚 详细文档

配置

在使用前，需要配置彩云天气API密钥。如果需要地址查询功能，还需要配置高德地图API密钥。

彩云天气API密钥

访问彩云天气网站
注册并登录账户
创建应用并获取 API Key

高德地图API密钥

访问高德地图开发者平台
登录并创建新项目
获取API访问令牌

使用说明

完成上述配置后，将以下信息添加到 config.js 文件中：

{
  "apiKey": "your_api_key", // 彩云天气 API Key
  "mapKey": "your_map_key"  // 高德地图 API 令牌
}

参数说明

公共参数

| 参数 | 详情 | |------|------| | lon | 经度 | | lat | 纬度 | | days | 预报天数（1 - 15，默认5） |

天气预警信息

GET /weather/alerts?lon=120.1234&lat=30.5678 HTTP/1.1
Host: your_domain

💻 使用示例

基础用法

实时天气查询

GET /weather/current?lon=120.1234&lat=30.5678 HTTP/1.1
Host: your_domain

天气预报查询

GET /weather/forecast?lon=120.1234&lat=30.5678&days=5 HTTP/1.1
Host: your_domain

📄 许可证

本项目采用 MIT 许可证。

Caiyun Weather