快速结论
Mireye Earth 把一个美国经纬度转换成可供 Agent 调用的结构化地理空间字段，并为每个值附上来源、上游 URL、数据年份、抓取时间和置信度。它提供 POST /v1/ask、POST /v1/fetch、公开字段目录以及托管 MCP 端点 https://api.mireye.com/mcp，适合保险初筛、贷款尽调、能源或数据中心选址等需要溯源而不是“让模型猜”的流程。
它的核心价值是 provenance，不是替代专业 GIS 或出具最终结论。覆盖范围只有美国，数据来自 USGS、NOAA、USDA、FEMA 等联邦机构，也包含 Sentinel-2、Overture Maps、Regrid 等开放或商业来源；因此不能把所有字段概括成联邦数据。confidence 反映服务对字段结果的置信桶，不等于监管认可或零误差。高影响决策必须核对数据年份、来源说明、status 与 partial_failures，再由合格人员回到原始数据、现场信息和适用规则复核。
核心功能
- 自然语言问答：
/v1/ask根据问题选择字段，返回带 citations 与fields_used的文字答案；需要确定性复核时应把这些字段交给/v1/fetch重放。 - 结构化字段获取：
/v1/fetch按字段名或 preset 返回值、单位、来源、数据年份、时间戳、TTL、置信度、状态和备注。 - 可发现目录：
GET /v1/meta/fields无需认证，可让 Agent 获取实时字段、preset、类型、来源与美国坐标边界。 - 托管与本地 MCP：托管端点位于
api.mireye.com/mcp；本地mireye-mcp适配器可通过 stdio 接入兼容客户端。 - 部分失败语义：成功的 HTTP 200 仍可能带
partial_failures；status: absent则表示来源确认该位置没有该值，两者不能混为一谈。 - 美国多层数据：覆盖地形、土地覆盖、建筑与道路、公用设施、能源、气候、灾害、地块和行政边界等用途。
适合人群
- AI Agent 开发者：需要通过 MCP 或 HTTP 引入可追溯的美国地理字段。
- 保险与贷款团队：把洪水、野火、地形、湿地或产权字段用于初筛与人工调查队列。
- 选址分析团队：初步比较能源、输电、水、气候、道路、地块和自然灾害约束。
- 需要留审计线索的应用：愿意保存字段来源、时间戳、置信度、请求 ID 和失败记录。
- 不太适合的人群：查询美国以外地点、需要完整 GIS 制图分析、把 API 结果当成估值或承保结论，或无法对高影响输出进行人工复核的团队。
使用场景
- 房产风险初筛：组合高程、洪泛区、海岸距离、湿地与自然灾害字段，把不确定结果转人工复核。
- 能源和数据中心选址：用 preset 初看输电、变电站、能源价格、气候、水、光伏或风资源，再进入工程与许可调查。
- 贷款与产权尽调辅助：获取边界、地块、洪水和保护地信息，同时保留来源与数据年份。
- 批量组合评估：按坐标调用确定字段，对低置信度、缺失或部分失败记录建立例外队列。
- 可复验 Agent 答案：先用
/v1/ask探索，再用/v1/fetch固定字段并周期性重跑差异。
价格与版本
截至 2026-07-21，Mireye Earth 仍处于免费 early access，官方说明是在与设计伙伴调整覆盖和限速，正式发布后的价格尚未公布。字段目录可公开读取；问答、字段获取、站点和 MCP 数据调用需要账户认证。免费不代表没有速率、字段、并发或服务可用性限制，生产系统应向服务方确认当前配额、SLA、数据缓存和商业使用条款。
本地 MCP 适配器代码以 MIT 许可发布，只说明适配器代码可按该许可证使用。Mireye 托管服务本身、API 输出、品牌以及各上游数据集不因此变成 MIT；联邦公共数据、开放数据和商业数据可能各有不同的使用、归属、再分发和缓存条件。做商业产品前，应逐项检查服务条款与响应中的 source_url，不要把“开源适配器”误写成“全部数据可无限制商用”。
国内访问与使用体验
官网、文档和 api.mireye.com 在本次核验中可直接访问，因此 needsVPN 标为 false；真实可用性仍受本地网络、账户授权和上游源状态影响。所有业务数据只覆盖美国坐标，大陆可访问并不意味着有中国数据。MCP 客户端可连接托管 Streamable HTTP 端点，也可运行本地 stdio 适配器；直接 HTTP 调用则使用 bearer token。
工程上最重要的是保留失败语义。/v1/fetch 返回 200 时仍要读取 partial_failures，按 retryable 决定是否重试；absent 是“来源确认无值”，不应盲目重试。高影响场景只看 confidence: high 也不够，还要核对 dataset_vintage、fetched_at、空间分辨率、字段备注和原始来源。坐标级聚合可能掩盖地块边界误差或数据更新滞后，最终判断应结合专业 GIS、文件审查和现场调查。
优点
- 每个字段都保留来源、链接、数据年份、时间戳与置信度，适合建立可检查的 Agent 输出链。
/v1/ask便于探索，/v1/fetch便于确定性调用，两种接口分工清楚。- MCP、HTTP 与公开字段目录同时提供，集成方式灵活。
- 明确区分
absent和partial_failures，比静默丢字段更适合生产系统。 - 常见风险与选址 preset 能减少开发者自行拼接多家数据源的工作量。
不足
- 仅覆盖美国，不能用于全球或中国地理查询。
- early access 暂无稳定公开价格与生产 SLA，限速和字段仍可能变化。
- 聚合多个上游源也继承其更新周期、分辨率、覆盖缺口和许可差异。
- 自然语言
/v1/ask的选字段可能变化，关键流程要转为固定字段调用。 - 置信度和引用不等于法律、保险、贷款或工程结论，仍需专业人员复核。
替代品对比
| 工具 | 更适合谁 | 优势 | 不足 |
|---|---|---|---|
| Cyanheads NWS Weather MCP Server | 只需美国天气观测的轻量 Agent | 目标单一、调用更简单 | 不覆盖地块、地形、能源和多灾种字段 |
| 新加坡政府开放数据 MCP | 需要新加坡官方开放数据的 MCP 用户 | 区域政府数据直接 | 地理覆盖与 Mireye 不同，不能替代美国数据 |
| Brave Search API | 需要开放网页检索与最新文字信息的 Agent | 搜索面广、适合补充背景 | 搜索结果不是标准化地理字段或逐字段 provenance |
| Tavily | 需要检索地点相关新闻、政策页面和网页背景的 Agent | 面向 Agent 的检索与正文提取 | 只能补充网页上下文，不提供结构化地理字段，不能替代 Mireye 的字段级来源和状态语义 |
| 直接调用 USGS/FEMA/NOAA 等源 | 有 GIS 工程能力并要求完全控制的团队 | 可按原始规范验证，少一层服务依赖 | 需要自己处理接口差异、空间连接、缓存和失败恢复 |
常见问题 FAQ
Mireye Earth 是什么？
它是美国地理空间字段的 API 与 MCP 服务。输入坐标和问题或字段名，可以得到带来源、时间和置信度的数据，用来给 Agent 提供可溯源上下文。
它只使用美国联邦数据吗？
不是全部。核心来源包括多个美国联邦机构，但官方 Agent 指南也列出 Sentinel-2、JRC、Overture Maps、Regrid 等开放或商业数据。应以每个响应字段的实际来源为准。
返回 high confidence 就能自动承保或批准贷款吗？
不能。置信度是服务字段的质量信号，不替代法规、专业判断、原始文件、现场核查或组织的审批控制。它适合初筛和证据收集，不应独立作出高影响决定。
HTTP 200 是否代表所有字段成功？
不一定。/v1/fetch 可能在 200 响应中返回 partial_failures。客户端必须检查该数组，并区分可重试失败与 status: absent 的有效空值。
MCP 适配器是 MIT，数据也都是 MIT 吗？
不是。MIT 适用于适配器代码，不自动覆盖托管服务、API 输出或上游数据集。商业使用和再分发要分别检查 Mireye 条款及字段来源许可。
Mireye Earth 免费吗？
early access 当前免费，正式价格尚未公布。生产部署前应确认限速、配额、SLA、缓存、支持和未来计费方式。
总结
Mireye Earth 适合给美国地理空间 Agent 增加逐字段溯源，而不是让通用模型凭常识回答洪水、地块或选址问题。评估时先调用公开目录，再用 /v1/fetch 测一组真实坐标，故意检查缺失和部分失败，并验证原始来源。只有当团队能保留 provenance、处理失败、遵守各数据权利并在高影响决策中设置专业复核，它才适合作为生产数据层。