Earthdata MCP Server

🪐 ✨ 地球数据MCP服务器

Earthdata MCP服务器是 模型上下文协议 （MCP）服务器实现，提供与之交互的工具 美国国家航空航天局地球数据.

此服务器有意仅用于Earthdata。

如果您需要笔记本电脑/运行时工具，请使用以下工具组合此服务器 jupyter-mcp-server 使用 mcp组成.

主要特点

• NASA地球数据的数据集发现
• 使用时间和边界框过滤器进行颗粒搜索
• 具有明确执行模式的灵活下载工作流程

Analyzing Sea Level Rise with AI-Powered Geospatial Tools and Jupyter - Watch Video

入门指南

本地安装

pip install earthdata-mcp-server

Docker与克劳德桌面

{
  "mcpServers": {
    "earthdata": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "datalayer/earthdata-mcp-server:latest"
      ],
      "env": {
        "EARTHDATA_USERNAME": "your_username",
        "EARTHDATA_PASSWORD": "your_password"
      }
    }
  }
}

Linux主机网络

{
  "mcpServers": {
    "earthdata": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "datalayer/earthdata-mcp-server:latest"
      ],
      "env": {
        "EARTHDATA_USERNAME": "your_username",
        "EARTHDATA_PASSWORD": "your_password"
      }
    }
  }
}

工具

服务器提供3个Earthdata工具。

search_earth_datasets

• 搜索美国国家航空航天局地球数据上的数据集。
• 输入：

- search_keywords（str）：在数据集标题中搜索的关键字。 - count（int）：要返回的数据集数量。 - temporal（tuple）：（可选）时间范围，格式为（date_from，date_to）。 - bounding_box（tuple）：（可选）格式为（lower_lift_lon、lower_left_lat、upper_right_lon、upper_right_lat）的边界框。

• 返回：数据集摘要列表。

search_earth_datagranules

• 在NASA地球数据中搜索数据颗粒。
• 输入：

- short_name（str）：数据集的简称。 - count（int）：要返回的数据颗粒数。 - temporal（tuple）：（可选）时间范围，格式为（date_from，date_to）。 - bounding_box（tuple）：（可选）格式为（lower_lift_lon、lower_left_lat、upper_right_lon、upper_right_lat）的边界框。

• 返回：数据颗粒列表。

download_earth_data_granules

• 使用显式模式搜索和可选下载颗粒。
• 认证：需要NASA地球数据登录凭据（请参阅 身份验证指南)
• 输入：

- folder_name（str）：用于保存数据的本地文件夹名称。 - short_name（str）：要下载的地球数据集的简称。 - count（int）：要下载的数据颗粒数。 - temporal（tuple）：（可选）时间范围，格式为（date_from，date_to）。 - bounding_box（tuple）：（可选）格式为（lower_lift_lon、lower_left_lat、upper_right_lon、upper_right_lat）的边界框。 - mode（str）：以下之一： - manifest：仅返回颗粒元数据。 - download：直接在服务器端下载文件。 - script：返回要在其他地方执行的Python代码。 - max_manifest_items（int）：返回的最大项目数 manifest 模式。

下载是如何工作的

download_earth_data_granules 始终从使用过滤器搜索颗粒开始，然后根据以下内容进行操作 mode:

1. manifest

- 返回结构化预览(items)带有ID、标题和链接。 - 不写入文件。 - 验证查询范围的最佳第一步。

1. download

- 使用环境凭据通过Earthdata进行身份验证。 - 将匹配颗粒直接下载到 folder_name 在服务器运行时。 - 返回下载的文件路径。

1. script

- 返回执行相同搜索+下载的可执行Python代码。 - 当执行发生在由另一个MCP服务器控制的笔记本电脑/运行时时的最佳选择。

推荐下载策略

1. 使用 mode="manifest" 首先要安全检查结果。
2. 使用 mode="script" 当你想通过笔记本电脑驱动执行时 mcp-compose + jupyter-mcp-server.
3. 使用 mode="download" 仅当打算进行服务器端文件写入时。

关于完整的构图示例 mcp-compose，请参阅 下载工作流文档.

提示

1. download_analyze_global_sea_level

- 生成以以下内容开头的工作流 download_earth_data_granules 在 script 模式。 - 旨在在组合的笔记本/运行时堆栈中执行（通过 mcp-compose).

1. sealevel_rise_dataset

- 搜索与全球海平面上升相关的数据集。 - 输入： - start_year （int）：开始考虑年份。 - end_year （int）：年底考虑。 - 返回：提示格式正确。

1. ask_datasets_format

- 询问数据集的格式。 - 返回：提示格式正确。

建筑

# or run `docker build -t datalayer/earthdata-mcp-server .`
make build-docker

如果你愿意，你可以提取预构建的图像。

make pull-docker