使用 Mirror Earth MCP 查询气象数据

在 Claude Desktop、Codex CLI、Cursor、Windsurf、Cline 等 MCP 客户端中配置 Mirror Earth MCP，通过自然语言查询与导出全球气象数据。

镜

镜像地球团队

Mirror Earth MCP 通过标准本地 stdio transport 向兼容 MCP 的 AI 客户端提供结构化气象工具。它适用于 Claude Desktop、Codex CLI、Cursor、Windsurf、Cline、Roo Code 以及其他支持本地 MCP server 的客户端。

启用服务后，AI Agent 可以发现模型和气象要素、查询预报与历史天气、解析地点，并创建或管理批量导出任务。

使用前准备

需要 Python 3.10 或更高版本。推荐安装 uv，以便通过 uvx 启动发布包。天气查询和批量导出需要从镜像地球个人中心获取 API Key；geocode 与 reverse_geocode 不需要 API Key。

warning

不要将真实 API Key 写入源代码、Git 提交、URL、截图或普通聊天内容。请通过客户端环境变量或安全配置界面保存密钥。

添加 MCP Server

在 MCP 客户端中新增名为 mirror-earth 的本地 Server。将 YOUR_MIRROR_EARTH_API_KEY 替换为真实密钥。

{
  "mcpServers": {
    "mirror-earth": {
      "command": "uvx",
      "args": ["mirror-earth-mcp"],
      "env": {
        "MIRROR_EARTH_API_KEY": "YOUR_MIRROR_EARTH_API_KEY"
      }
    }
  }
}

若无法使用 uvx，请先在客户端使用的 Python 环境中安装包：

python -m pip install mirror-earth-mcp
python -m mirror_earth_mcp.server

随后将该 Python 解释器设置为 command，并使用 [-m, mirror_earth_mcp.server] 作为参数。

Codex CLI

可在终端直接添加服务：

codex mcp add mirror-earth --env MIRROR_EARTH_API_KEY=YOUR_MIRROR_EARTH_API_KEY -- uvx mirror-earth-mcp

其它 MCP 客户端

Claude Desktop：将 mirror-earth 对象放入 claude_desktop_config.json 的 mcpServers。Windows 常见路径为 %APPDATA%\Claude\claude_desktop_config.json。
Cursor：在 MCP 设置中添加同一份配置，或在项目根目录创建 .cursor/mcp.json。
Windsurf：在 MCP 设置中添加，或写入 ~/.codeium/windsurf/mcp_config.json。
Cline / Roo Code：添加 stdio Server，命令为 uvx，参数为 mirror-earth-mcp，并设置 MIRROR_EARTH_API_KEY 环境变量。

保存配置后重启或重新加载 MCP 服务。

可用工具

能力	工具
模型与要素目录	`list_models`、`get_model_details`、`list_variables`
天气查询	`get_forecast`、`get_historical_weather`、`get_archive_forecast`、`get_seamless_weather`
地名解析	`geocode`、`reverse_geocode`
批量导出	`get_batch_usage`、`estimate_batch_export`、`create_batch_export`、`get_batch_task`、`list_batch_tasks`、`cancel_batch_task`

服务还提供 mirror-earth://references/... MCP 资源，用于读取内置的 API 与模型参考资料。

可以这样提问

查询上海未来 7 天的气温、降水和 10 米风速，并用表格总结。
比较北京未来 5 天 ECMWF、GFS、CMA 和 GraphCast 的降水预报差异。
分析 2021 年 7 月郑州暴雨期间的逐小时气温和降水。
导出江苏省 2010 到 2024 年的 ERA5 每日天气数据，先预估配额和输出大小。

源码与发布说明：Mirror Earth MCP。