🚀 彩云天气 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 许可证。