🌎 ✨ Jupyter Earth MCP 服务器

🌍 Jupyter Earth MCP 服务器是一个 模型上下文协议 (MCP) 服务器实现，它提供了一套工具，用于在 📓 Jupyter 笔记本中进行 🗺️ 地理空间分析。

以下演示使用 Earthdata MCP 服务器 在 NASA Earthdata 上搜索数据集和数据颗粒，使用此 MCP 服务器在 Jupyter 中下载数据，并使用 jupyter-mcp-server 运行进一步的分析。

<div> <a href="https://www.loom.com/share/c2b5b05f548d4f1492d5c107f0c48dbc"> <p>使用 AI 驱动的地理空间工具和 Jupyter 分析海平面上升 - 观看视频</p> </a> <a href="https://www.loom.com/share/c2b5b05f548d4f1492d5c107f0c48dbc"> <img style="max-width:100%;" src="https://cdn.loom.com/sessions/thumbnails/c2b5b05f548d4f1492d5c107f0c48dbc-598a84f02de7e74e-full-play.gif"> </a> </div>

启动 JupyterLab

请确保您已安装以下组件。由于 Jupyter 实时协作，因此需要协作包才能看到在笔记本上所做的修改。

pip install jupyterlab jupyter-collaboration ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt

然后，使用以下命令启动 JupyterLab。

jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0

您也可以运行 make jupyterlab。

[!NOTE]

--ip 设置为 0.0.0.0，以允许在 Docker 容器中运行的 MCP 服务器访问您的本地 JupyterLab。

与 Claude Desktop 一起使用

可以从此页面下载适用于 macOS 和 Windows 的 Claude Desktop。

对于 Linux，我们成功使用了这个基于 nix 的非官方构建脚本

# ⚠️ 非官方
# 您也可以运行 `make claude-linux`
NIXPKGS_ALLOW_UNFREE=1 nix run github:k3d3/claude-desktop-linux-flake \
  --impure \
  --extra-experimental-features flakes \
  --extra-experimental-features nix-command

要将其与 Claude Desktop 一起使用，请将以下内容添加到您的 claude_desktop_config.json 中（有关更多信息，请阅读 MCP 文档网站）。

[!IMPORTANT]

确保 SERVER_URL 和 TOKEN 的端口与 jupyter lab 命令中使用的端口匹配。

NOTEBOOK_PATH 应该相对于 JupyterLab 启动的目录。

macOS 和 Windows 上的 Claude 配置

{
  "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 配置

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
cat $CLAUDE_CONFIG

组件

工具

该服务器目前提供 1 个工具：

1. download_earth_data_granules

• 在 Jupyter 笔记本中添加一个代码单元格，以下载来自 NASA Earth Data 的地球数据颗粒。
• 输入：
  • folder_name(string): 用于保存数据的本地文件夹名称。
  • short_name(string): 要下载的地球数据集的简称。
  • count(int): 要下载的数据颗粒的数量。
  • temporal (tuple): (可选) 格式为 (date_from, date_to) 的时间范围。
  • bounding_box (tuple): (可选) 格式为 (lower_left_lon, lower_left_lat, upper_right_lon, upper_right_lat) 的边界框。
• 返回：单元格输出。

构建

您可以从源代码构建 Docker 镜像。

make build-docker