使用说明
彩云气象MCP服务器
托管服务器
彩云天气提供了一个托管的流式HTTP MCP服务器，因此您可以使用 天气工具，无需在本地安装或运行此软件包。
{
"url": "https://mcp-weather.caiyunapp.com/mcp",
"headers": {
"X-Caiyun-API-Key": "YOUR_CAIYUN_WEATHER_API_KEY"
}
}
外部配置格式取决于您的MCP客户端。在得到之前
起动， 注册并申请彩云天气API密钥,
然后通过 X-Caiyun-API-Key 请求标头。
安装说明
先安装uv。
MacOS/Linux：
curl -LsSf https://astral.sh/uv/install.sh | sh
窗户：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
使用Claude Desktop进行设置
# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"caiyun-weather": {
"command": "uvx",
"args": ["mcp-caiyun-weather"],
"env": {
"CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
}
}
}
}
问克劳德一个关于天气的问题
例如：“现在北京的天气怎么样？”
本地/开发设置说明
使用Claude Desktop进行设置
# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"caiyun-weather": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather",
"run",
"mcp-caiyun-weather"
],
"env": {
"CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
}
}
}
}
调试
运行：
npx @modelcontextprotocol/inspector \
uv \
--directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather \
run \
mcp-caiyun-weather
可用工具
-
get_realtime_weather：获取特定位置的实时天气数据- 参数：
lng：位置的经度lat：位置的纬度
- 返回详细信息，包括：
- 温度和表观温度
- 天空状况
- 湿度
- 风速与风向
- 降水强度
- 空气质量指标（PM2.5、PM10、O3、SO2、NO2、CO）
- AQI（中国和美国标准）
- 寿命指数（紫外线和舒适度）
- 参数：
-
get_hourly_forecast：获取可配置小时数的每小时天气预报- 参数：
lng：位置的经度lat：位置的纬度hours：返回的小时数(1–360，默认为72)
- 返回每小时预测，包括：
- 温度
- 天气状况
- 降雨概率
- 降水强度（mm/hr）
- 风速与风向
- 参数：
-
get_weekly_forecast：获取未来7天的每日天气预报- 参数：
lng：位置的经度lat：位置的纬度
- 返回每日预测，包括：
- 温度范围（最小/最大）
- 天气状况
- 降雨概率
- 参数：
-
get_historical_weather：获取过去24小时的历史天气数据- 参数：
lng：位置的经度lat：位置的纬度
- 返回历史数据，包括：
- 温度
- 天气状况
- 参数：
-
get_weather_alerts：获取特定位置的天气警报- 参数：
lng：位置的经度lat：位置的纬度
- 返回天气警报，包括：
- 警报标题
- 警报代码
- 警戒状态
- 警报说明
- 参数：
注意：所有工具都需要在环境变量中设置有效的彩云天气API令牌 CAIYUN_WEATHER_API_TOKEN.
