Jupyter MCP Server

Jupyter MCP Server是一個實現模型上下文協議(MCP)的服務，支持與Jupyter筆記本交互。

開發者工具研究與數據 #Jupyter交互 #MCP協議 #代碼執行 #筆記本協作 .JavaScript

評分 : 3.5分

下載量 : 267

更新時間 : 2025-04-28

什麼是Jupyter MCP 服務器？

Jupyter MCP 服務器是一個支持Model Context Protocol (MCP) 的工具，它允許您在JupyterLab中通過Claude等工具即時編輯和交互Jupyter筆記本。它支持添加代碼單元格、執行代碼以及插入Markdown內容。

如何使用Jupyter MCP 服務器？

首先需要安裝相關依賴並啟動JupyterLab，然後配置Claude桌面客戶端以連接到本地的JupyterLab實例。

適用場景

適用於需要多人協作開發Jupyter筆記本的團隊，尤其適合數據科學家和研究人員。

主要功能

添加並執行代碼單元格允許在Jupyter筆記本中動態添加新的代碼單元格並立即運行它們。

添加Markdown單元格可以輕鬆插入Markdown格式的文本，方便註釋和文檔撰寫。

優勢與侷限性

優勢

支持多人即時協作編輯Jupyter筆記本。

提供強大的API接口來擴展功能。

集成Claude等高級AI工具，提升生產力。

侷限性

需要一定的環境配置，可能對新手不太友好。

僅限於JupyterLab環境下的使用。

如何使用

安裝依賴

確保已安裝JupyterLab、Jupyter-Collaboration以及ipykernel。

啟動JupyterLab

使用以下命令啟動JupyterLab，並確保設置了正確的IP地址和端口。

配置Claude客戶端

根據文檔添加相應的配置文件，確保服務器URL和令牌匹配。

使用案例

案例1：添加代碼單元格在Jupyter筆記本中動態添加一個Python代碼單元格並執行。

案例2：插入Markdown單元格向筆記本中插入一段Markdown格式的文本。

常見問題

如何確保Claude客戶端可以訪問本地JupyterLab？

是否可以在Linux上使用該工具？

🚀 🪐 ✨ Jupyter MCP 服務器

Jupyter MCP 服務器是一個 Model Context Protocol (MCP) 服務器實現，它提供了與 📓 Jupyter 筆記本的交互功能，這些筆記本可在任何 JupyterLab（包括本地 JupyterLab）中運行，為用戶帶來便捷的操作體驗。

🚀 快速開始

啟動 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。

⚠️ 重要提示

--ip 設置為 0.0.0.0 是為了使 MCP 服務器在 Docker 容器中運行時能夠訪問你的本地 JupyterLab。

與 Claude Desktop 結合使用

Claude Desktop 可以從這個頁面下載，適用於 macOS 和 Windows。對於 Linux，我們成功使用了基於 nix 的 UNOFFICIAL 構建腳本

# ⚠️ UNOFFICIAL
# 你也可以運行 `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 官方文檔網站）。

⚠️ 重要提示

SERVER_URL 的值取決於你運行 JupyterLab 的位置。如果是在本地運行，應設置為 http://localhost:8888；如果是通過雲服務器，則需要相應的 URL 和端口。

配置示例

對於 macOS 或 Windows：

cat $HOME/.config/Claude/desktop_config/claude_desktop_config.json

輸出可能如下：

{
  "mcp_server": {
    "add_execute_code_cell": {
      "description": "添加並執行 Jupyter 筆記本中的代碼單元格",
      "parameters": [
        {
          "name": "cell_content",
          "type": "string",
          "description": "要執行的代碼"
        }
      ],
      "returns": "單元格輸出"
    },
    "add_markdown_cell": {
      "description": "添加 Jupyter 筆記本中的 Markdown 單元格",
      "parameters": [
        {
          "name": "cell_content",
          "type": "string"
        }
      ]
    }
  }
}

Jupyter MCP 服務器

📦 安裝指南

安裝必要軟件包

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。

💻 使用示例

基礎用法

啟動 JupyterLab 並與 Claude Desktop 結合使用的基本流程如下：

# 安裝軟件包
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

高級用法

在 Linux 系統上使用基於 nix 的 UNOFFICIAL 構建腳本與 Claude Desktop 結合使用：

# ⚠️ UNOFFICIAL
# 你也可以運行 `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