Datalayer Jupyter MCP Server

🚀 🪐 ✨ Jupyter MCP 服務器

Jupyter MCP 服務器可助力你啟動 JupyterLab 並實現即時協作，還能與 Claude Desktop 結合使用，為你提供便捷的筆記本操作體驗。

🚀 快速開始

啟動 JupyterLab

請確保安裝了以下內容。對筆記本的修改可以通過 Jupyter 即時協作（RTC）看到。

pip install jupyterlab jupyter-collaboration ipykernel

然後，使用以下命令啟動 JupyterLab：

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

⚠️ 重要提示

將 --ip 設置為 0.0.0.0 以便運行在 Docker 容器中的 MCP 服務器能夠訪問您的本地 JupyterLab。

與 Claude Desktop 結合使用

要將其與 Claude Desktop 結合使用，請將以下內容添加到 claude_desktop_config.json 中：

⚠️ 重要提示

確保 SERVER_URL 和 TOKEN 的端口與 jupyter lab 命令中使用的匹配。NOTEBOOK_PATH 應該相對於 JupyterLab 啟動目錄。

MacOS 和 Windows

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

Linux

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

✨ 主要特性

組件 - 工具

當前服務器提供兩個工具：

1. add_execute_code_cell

• 在 Jupyter 筆記本中添加並執行一個代碼單元格。
• 輸入：
  • cell_content(字符串)：要執行的代碼
• 返回：成功消息

2. add_markdown_cell

• 在 Jupyter 筆記本中添加一個 Markdown 單元格。
• 輸入：
  • cell_content(字符串)：Markdown 內容
• 返回：成功消息

📦 安裝指南

構建

docker build -t datalayer/jupyter-mcp-server .

通過 Smithery 安裝

要通過 Smithery 自動安裝 Jupyter MCP Server 用於 Claude Desktop：

npx -y @smithery/cli install @datalayer/jupyter-mcp-server --client claude