Jupyter MCP Server

🚀 🪐 ✨ 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"
        }
      ]
    }
  }
}

📦 安裝指南

安裝必要軟件包

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