Mirror Earth MCP 更新：在线接入与 3 天开发者版会员体验

Mirror Earth MCP 现支持推荐的在线 HTTP 接入方式，并新增 3 天开发者版会员体验领取工具；连接后即可由 AI Agent 查询天气、管理批量导出任务。

镜

镜像地球团队

Mirror Earth

Mirror Earth MCP 已完成更新。除了原有的本地 stdio 模式，现在更推荐通过在线 HTTP MCP 直接接入：无需安装 Python、uv 或本地包，服务端会持续更新，团队与个人都能稳定使用最新版。

同时，我们上线了开发者体验活动：通过 MCP 完成连接后，可领取 3 天开发者版会员体验，每个账户限领一次。 领取资格与 API Key 绑定，状态由服务端独立记录。

本次更新一览

新增在线 MCP：使用正式服务地址接入，免安装、免维护、持续获得最新能力。
保留本地 MCP：支持 uvx mirror-earth-mcp，适合离线网络、本地调试、二次开发和自托管场景。
新增会员体验工具：AI Agent 可调用 claim_trial_membership 领取 3 天开发者版会员体验，并通过 get_trial_status 查询领取状态。
工具与资料更完整：支持模型与要素目录、预报与历史天气、地名解析、批量导出任务管理；还可通过 mirror-earth://references/... 读取内置 API 与模型参考资料。

推荐方式：在线 HTTP MCP

在线 MCP 不需要在本地安装运行环境。在支持远程 HTTP MCP 的客户端中添加以下配置，并将 YOUR_MIRROR_EARTH_API_KEY 替换为你的真实 API Key：

{
  "mcpServers": {
    "mirror-earth": {
      "type": "http",
      "url": "https://api.mirror-earth.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_MIRROR_EARTH_API_KEY"
      }
    }
  }
}

API Key 可在镜像地球开放平台个人中心获取。服务会透传该请求头，因此不同用户的配额、会员等级和试用领取状态彼此独立。

warning

请勿将真实 API Key 提交到代码仓库、写入截图或粘贴到公开讨论中。建议仅通过客户端的安全配置界面、请求头或环境变量保存密钥。

本地 MCP：适合调试与自托管

如果需要在本地运行、离线网络中使用，或希望固定运行版本，可继续使用 stdio 模式。需要 Python 3.10+ 与 uv。

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

本地模式由用户自行更新包和重启运行环境；如果没有本地调试或自托管需求，建议优先选择在线 MCP。

如何领取 3 天开发者版会员体验

完成 MCP 配置并重新加载服务后，在已连接 Mirror Earth MCP 的 Agent 中发送：

调用 claim_trial_membership，领取 Mirror Earth 3 天开发者版会员体验；然后调用 get_trial_status 告诉我领取结果和当前状态。

领取规则：

使用你自己的 Mirror Earth API Key 连接 MCP。
每个账户仅可领取一次 3 天开发者版会员体验。
可随时让 Agent 调用 get_trial_status 查询是否已领取及当前状态。
若已经领取过，服务会返回对应状态，不会重复发放。

Agent 现在可以做什么

场景	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`
领取与查询体验会员	`claim_trial_membership`、`get_trial_status`

例如，你可以直接对 Agent 说：

查询上海未来 7 天的气温、降水和 10 米风速，并用表格总结。
比较北京未来 5 天 ECMWF、GFS、CMA 和 GraphCast 的降水预报差异。
分析 2021 年 7 月郑州暴雨期间的逐小时气温和降水。
导出江苏省 2010 到 2024 年的 ERA5 每日天气数据，先预估配额和输出大小。
领取 Mirror Earth 3 天开发者版会员体验，并告诉我当前领取状态。

客户端配置提示

Claude Desktop：在远程 HTTP MCP 设置中添加服务地址和 X-API-Key 请求头。
Cursor：在 MCP 设置或项目 .cursor/mcp.json 中添加配置。
Windsurf：在 MCP 设置或 ~/.codeium/windsurf/mcp_config.json 中添加配置。
Cline、Roo Code 等：在 MCP Servers 设置中选择远程 HTTP MCP，填写服务地址和请求头。

完整源码、配置模板与部署说明请访问 Mirror Earth MCP。