Documentation
彩云天气 MCP 服务器
基于彩云天气 API 的 Model Context Protocol (MCP) 服务器，提供天气数据查询功能。
功能特点
- 实时天气数据：温度、湿度、风速、气压、能见度等
- 分钟级降水预报：未来2小时的降水情况
- 小时级天气预报：未来24小时或更长时间的天气预报
- 每日天气预报：未来多天的天气预报
- 天气预警信息：各类天气预警
- 空气质量趋势：24小时空气质量变化趋势和主要污染物分析
- 详细生活指数：运动、旅行、洗车、穿衣等详细生活建议
- 降水类型识别：区分雨、雪、雨夹雪、冰雹等降水类型
- 地址查询：支持通过地址查询天气，内置35个主要城市坐标缓存，无需额外配置即可使用
- 多语言支持：支持中文和英文
- 单位制选择：支持公制和英制
安装
安装 Smithery
通过 Smithery 安装 彩云天气 对于Claude的桌面应用：
npm install @smithery/cli -g
smithery install @pepperai/caiyun-weather-mcp通过 NPX 使用
您可以直接通过 NPX 运行：
npx caiyun-weather-mcp --api-key=您的彩云天气API密钥或者设置环境变量：
CAIYUN_API_KEY=您的密钥 npx caiyun-weather-mcp从源码安装
1. 克隆仓库：
git clone https://github.com/marcusbai/caiyun-weather-mcp.git
cd caiyun-weather-mcp2. 安装依赖：
npm install注意：本项目依赖于 Model Context Protocol (MCP) SDK，该SDK需要在运行环境中可用。MCP SDK通常由Claude或其他支持MCP的应用程序提供。
3. 构建项目：
npm run build配置
在使用前，需要配置彩云天气API密钥。地址查询功能支持内置城市缓存，高德地图API密钥为推荐配置。
彩云天气API密钥
1. 访问 彩云天气开发者中心
2. 注册并登录账号
3. 创建应用并获取API密钥
高德地图API密钥（推荐）
1. 访问 高德开放平台
2. 注册并登录账号
3. 创建应用并获取API密钥，需要启用"地理编码"服务
💡 提示：高德地图API密钥为推荐配置。系统内置了35个主要城市的坐标缓存，包括所有直辖市、省会城市和经济发达城市，无需额外配置即可使用。
地址解析功能
支持的城市
系统内置了以下35个主要城市的坐标缓存：
直辖市：北京、上海、天津、重庆
省会及主要城市：广州、深圳、杭州、南京、武汉、成都、西安、长沙、沈阳、大连、青岛、厦门、苏州、郑州、济南、哈尔滨、石家庄、太原、合肥、南昌、福州、南宁、昆明、贵阳、兰州、西宁、拉萨、呼和浩特、海口、银川、乌鲁木齐
智能地址匹配
支持多种地址格式和智能匹配：
- 标准格式：
上海、上海市 - 详细地址：
上海市浦东新区、北京市朝阳区 - 城市别名：
魔都→上海、帝都→北京、羊城→广州、鹏城→深圳等
地址解析策略
1. 缓存优先：内置城市坐标立即返回
2. API增强：配置高德API后支持任意地址
3. 降级处理：未知地址返回北京坐标并提示配置
配置MCP设置
编辑MCP设置文件，添加彩云天气MCP服务器配置：
{
"mcpServers": {
"caiyun-weather": {
"command": "node",
"args": ["完整路径/caiyun-weather-mcp/dist/index.js"],
"env": {
"CAIYUN_API_KEY": "您的彩云天气API密钥",
"AMAP_API_KEY": "您的高德地图API密钥（推荐）"
},
"disabled": false,
"autoApprove": []
}
}
}如果您通过 NPX 安装了本服务，可以使用以下配置：
{
"mcpServers": {
"caiyun-weather": {
"command": "npx",
"args": ["caiyun-weather-mcp"],
"env": {
"CAIYUN_API_KEY": "您的彩云天气API密钥",
"AMAP_API_KEY": "您的高德地图API密钥（推荐）"
},
"disabled": false,
"autoApprove": []
}
}
}使用示例
根据经纬度获取天气信息
caiyun-weather
get_weather_by_location
{
"longitude": 116.3976,
"latitude": 39.9075,
"daily_steps": 5,
"hourly_steps": 24,
"language": "zh_CN",
"unit": "metric"
}根据地址获取天气信息
caiyun-weather
get_weather_by_address
{
"address": "上海市",
"daily_steps": 5,
"hourly_steps": 24,
"language": "zh_CN",
"unit": "metric"
}获取实时天气数据
caiyun-weather
get_realtime_weather
{
"longitude": 116.3976,
"latitude": 39.9075,
"language": "zh_CN",
"unit": "metric"
}获取分钟级降水预报
caiyun-weather
get_minutely_forecast
{
"longitude": 116.3976,
"latitude": 39.9075,
"language": "zh_CN",
"unit": "metric"
}获取小时级天气预报
caiyun-weather
get_hourly_forecast
{
"longitude": 116.3976,
"latitude": 39.9075,
"hourly_steps": 24,
"language": "zh_CN",
"unit": "metric"
}获取每日天气预报
caiyun-weather
get_daily_forecast
{
"longitude": 116.3976,
"latitude": 39.9075,
"daily_steps": 5,
"language": "zh_CN",
"unit": "metric"
}获取天气预警信息
caiyun-weather
get_weather_alert
{
"longitude": 116.3976,
"latitude": 39.9075,
"language": "zh_CN",
"unit": "metric"
}获取空气质量趋势
caiyun-weather
get_air_quality_trend
{
"longitude": 116.3976,
"latitude": 39.9075,
"language": "zh_CN",
"unit": "metric"
}获取详细生活指数
caiyun-weather
get_detailed_life_index
{
"longitude": 116.3976,
"latitude": 39.9075,
"language": "zh_CN",
"unit": "metric"
}参数说明
通用参数
longitude：经度latitude：纬度address：地址（仅用于get_weather_by_address）daily_steps：每日预报天数（1-15，默认5）hourly_steps：小时预报数量（1-360，默认24）language：语言（zh_CN或en_US，默认zh_CN）unit：单位制（metric或imperial，默认metric）
许可证
MIT
Similar MCP
Based on tags & features
Trending MCP
Most active this week