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

如需更多信息，請參考項目文檔或與我們聯繫。