xmo-weather气象数据MCP服务器
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"xmo-weather": {
"args": [
"-y",
"xmo-weather-mcp"
],
"command": "npx",
"env": {
"XMO_APIKEY": "your_api_key_here"
}
}
}
}可用工具 （4 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
estimate_weather_cost 4 个参数 需填 2 项
估算天气数据查询费用 **用途**: 在实际查询前，先估算费用并告知用户 **典型用法**: 用户: "查询(120,30)未来3天15分钟颗粒度的光伏相关天气数据" AI: 先调用此工具估算费用 → 告诉用户费用 → 等待用户确认 → 再调用query_weather_data **返回**: 预估调用量、数据点数等费用信息
必填参数：start_datetime、end_datetime
query_weather_data 7 个参数 需填 4 项
查询天气数据 (用户确认费用后调用) **前置要求**: 必须先调用estimate_weather_cost获得费用，用户确认后再调用本工具 **时间范围**: 1940-01-01 ~ D+14 (14天预报) **时间粒度**: 5/15/30/60 分钟 **use_case 场景**: - basic: 温度、湿度、降水、风速（默认） - solar/光伏: 辐射、温度、云量、日照 - wind/风电: 多高度风速、风向、温度 - air_quality/空气质量: PM2.5, PM10, AQI, 臭氧
必填参数：latitude、longitude、start_datetime、end_datetime
estimate_climate_cost 3 个参数 需填 2 项
估算气候数据查询费用 **用途**: 在实际查询前，先估算费用并告知用户 **典型用法**: 用户: "查询(120,30)未来一年的光伏相关气候数据" AI: 先调用此工具估算费用 → 告诉用户费用 → 等待用户确认 → 再调用query_climate_data **返回**: 预估调用量、天数等费用信息
必填参数：start_date、end_date
query_climate_data 6 个参数 需填 4 项
查询气候数据 (用户确认费用后调用) **前置要求**: 必须先调用estimate_climate_cost获得费用，用户确认后再调用本工具 **时间范围**: 历史数据 ~ 未来50年 **时间粒度**: 按日 (daily) **use_case 场景**: - basic: 温度、降水、湿度、风速（默认） - solar/光伏: 辐射、温度、云量、蒸发量 - wind/风电: 风速、温度、气压 - agriculture/农业: 温度、降水、湿度、土壤湿度
必填参数：latitude、longitude、start_date、end_date
服务介绍
xmo-weather-mcp
xmo-weather-mcp 是一个基于 Model Context Protocol（MCP） 的气象与气候数据服务扩展，允许 Claude、AgentBox、Cursor 等兼容 MCP 的客户端，在对话中直接调用 高精度天气与长期气候数据。
该 MCP Server 面向 光伏、风电、农业等行业场景，支持从分钟级天气预报到跨几十年的气候趋势分析，并内置费用/调用量预估能力，适合自动化与企业级使用。
功能概览
🌍 气候数据（Climate Data）
- 时间跨度：历史数据 + 未来 50 年
- 时间粒度：日级（Daily）
- 应用场景
- Basic：温度、降水、湿度、风速
- Solar：辐射、温度、云量、蒸发量
- Wind：风速、温度、气压
- Agriculture：温度、降水、湿度、土壤湿度
⏱ 天气数据（Weather Data）
- 时间跨度：历史数据（1940 年起）+ 未来 14 天
- 时间粒度：5 / 15 / 30 / 60 分钟
- 应用场景
- Basic：温度、湿度、降水、风速
- Solar：辐射、温度、云量、日照
- Wind：多高度风速、风向、温度
- Air Quality：PM2.5、PM10、AQI、臭氧
💰 调用量 / 费用预估
在实际获取数据前，支持先调用成本预估工具：
estimate_climate_costestimate_weather_cost
用于在消耗额度或产生费用前确认调用规模。
快速开始
第 0 步：获取 API Key
使用 xmo-weather-mcp 前，需要在官网注册并创建 API Key：
👉 https://www.xm-opt.com/account-setting#APIKey
获取后请妥善保存，用于 MCP Server 配置。
安装方式（推荐）：使用 npx 一键接入 MCP
前置条件
- Node.js 18+（建议 20+）
- 支持
npx
验证：
node -v
npm -v
npx -v
安装到 MCP 客户端（Claude / AgentBox / Cursor 等）
在客户端的 MCP 配置文件中（如 Claude Desktop 的 claude_desktop_config.json），添加：
{
"mcpServers": {
"xmo-weather": {
"command": "npx",
"args": [
"-y",
"xmo-weather-mcp"
],
"env": {
"XMO_APIKEY": "your_api_key_here"
}
}
}
}
说明：
xmo-weather-mcp为官方发布的 npm 包XMO_APIKEY替换为你在官网获取的真实 API Key- 如果已有其他 MCP Server，请注意 JSON 逗号分隔
环境变量说明
| 变量名 | 说明 |
|---|---|
| XMO_APIKEY | 官网申请的 API Key（必填） |
使用示例（对话中直接使用）
配置完成后，可直接在客户端中提问，例如：
- “给我上海未来 14天 15 分钟级的温度、风速和降水”
- “获取某风电场（经纬度：120.1, 30.2）未来14天的多高度风速与风向数据”
- “查询杭州西湖区黄龙时代广场未来30天的气候数据”
推荐工作流（先估算，再获取）
- 使用
estimate_climate_cost或estimate_weather_cost估算调用量 - 确认后再执行对应的天气或气候数据查询工具
AgentBox（推荐 MCP 客户端）
AgentBox（XMOBOX） 是 XMO 自研的本地智能终端客户端，面向企业级场景设计，支持完整的 MCP 生态，可作为 Cursor 等通用客户端的本地化替代方案。
👉 产品介绍：https://www.xm-opt.com/product/XMOBOX
为什么选择 AgentBox
- 本地部署，数据不出企业网络
- 完整支持 MCP Server（如 xmo-weather-mcp）
- 企业级权限控制与审计能力
- 支持多工具、多 Agent 协同
- 更适合新能源、工业、政企等场景
在 AgentBox 中，同样可以通过 MCP 配置文件接入 xmo-weather-mcp，并在对话中直接调用气象与气候数据能力。
常见问题
Q：为什么估算成功但查询失败？
- API Key 未配置或无权限
- 查询范围超过当前额度
- 参数（时间、站点、粒度）不合法
Q：如何查看套餐或额度？
请前往官网控制台查看账户信息。
更多信息
- 官网：https://www.xm-opt.com
- API Key 管理：https://www.xm-opt.com/account-setting#APIKey
- 产品（AgentBox）：https://www.xm-opt.com/product/XMOBOX
xmo-weather-mcp 让高精度气象与气候数据，成为大模型可直接使用的能力基础。
