Jupyter Earth MCP Server

🚀 🌍 ✨ Jupyter 地球 MCP 服务器

Jupyter 地球 MCP 服务器是一款基于 Docker 的实用工具，它能够助力用户在 Jupyter Notebook 中轻松下载和分析地球科学数据。该工具不仅支持从 NASA Earth Data 下载指定数据集，还具备与 Claude Desktop 集成的强大功能。

🚀 快速开始

启动 JupyterLab

首先，我们需要安装必要的依赖项，然后启动 Jupyter Notebook。具体操作步骤如下：

pip install jupyter notebook requests

接着，使用以下命令启动 Jupyter Notebook：

jupyter notebook --ip=0.0.0.0 --port=8888

配置 Docker 镜像

使用以下命令来配置 Docker 镜像：

make build-docker

✨ 主要特性

• 基于 Docker 构建，方便部署和使用。
• 支持从 NASA Earth Data 下载指定的地球科学数据集。
• 可与 Claude Desktop 集成，拓展功能。

📦 安装指南

启动 JupyterLab

1. 安装依赖：

pip install jupyter notebook requests

2. 启动 Jupyter Notebook：

jupyter notebook --ip=0.0.0.0 --port=8888

配置 Docker 镜像

make build-docker

💻 使用示例

与 Claude Desktop 集成

Windows 和 macOS 配置

{
  "mcpServers": {
    "jupyter-earth": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERVER_URL",
        "-e",
        "TOKEN",
        "-e",
        "NOTEBOOK_PATH",
        "datalayer/jupyter-earth-mcp-server:latest"
      ],
      "env": {
        "SERVER_URL": "http://host.docker.internal:8888",
        "TOKEN": "MY_TOKEN",
        "NOTEBOOK_PATH": "notebook.ipynb"
      }
    }
  }
}

Linux 配置

CLAUDE_CONFIG=${HOME}/.config/Claude/claude_desktop_config.json
cat <<EOF > $CLAUDE_CONFIG
{
  "mcpServers": {
    "jupyter-earth": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERVER_URL",
        "-e",
        "TOKEN",
        "-e",
        "NOTEBOOK_PATH",
        "--network=host",
        "datalayer/jupyter-earth-mcp-server:latest"
      ],
      "env": {
        "SERVER_URL": "http://localhost:8888",
        "TOKEN": "MY_TOKEN",
        "NOTEBOOK_PATH": "notebook.ipynb"
      }
    }
  }
}
EOF

📚 详细文档

功能组件

工具

• download_earth_data_granules：
  • 功能：在 Jupyter Notebook 中添加代码单元格以从 NASA Earth Data 下载数据条。
  • 输入：
    • folder_name（字符串）：本地文件夹名称，用于保存数据。
    • short_name（字符串）：要下载的地球数据集的短名称。
    • count（整数）：要下载的数据条数目。
    • temporal（元组）：（可选）时间范围，格式为 (date_from, date_to)。
    • bounding_box（元组）：（可选）边界框，格式为 (lower_left_lon, lower_left_lat, upper_right_lon, upper_right_lat)。
  • 输出：单元格输出。

提示

• download_analyze_global_sea_level：
  • 功能：请求下载并分析全球海平面数据的提示。
  • 输出：正确格式化的提示。

视频演示

构建镜像

make build-docker

如需更多信息，请参考项目文档或与我们联系。