Jupyter MCP Server Kshitij

🚀 Jupyter MCP 服務器客戶端

此項目提供了一個基於 Docker 的客戶端，用於連接支持多協作協議的 Jupyter 服務器。特別適用於在 Claude 桌面環境下的 Windows 和 Mac 用戶，為其帶來便捷的使用體驗。

🚀 快速開始

本項目的客戶端可幫助你在特定環境下連接 Jupyter 服務器，以下是詳細的使用步驟。

✨ 主要特性

• 基於 Docker 構建，方便部署和使用。
• 支持多協作協議的 Jupyter 服務器連接。
• 適用於 Windows 和 Mac 在 Claude 桌面環境下使用。

📦 安裝指南

先決條件

• Python 3.12.10
• Docker
• Git

安裝步驟

1. 設置 Python 環境

# 創建並激活虛擬環境
python3.12 -m venv env
source env/bin/activate  # Windows: env\Scripts\activate

# 安裝包管理器
pip install uv

# 安裝所需包
uv pip install jupyterlab jupyter-collaboration ipykernel pycrdt
uv pip install jupyter-nbmodel-client jupyter_kernel_client

# 修復依賴項（兼容性要求）
pip uninstall -y jupyter_server_ydoc pycrdt
uv pip install jupyter_server_ydoc pycrdt

2. 創建您的筆記本

# 克隆倉庫 -> 必須要進行此步驟
git clone https://github.com/kshitijdesai99/jupyter_mcp_server_kshitij.git
cd jupyter_mcp_server_kshitij
touch notebook.ipynb

3. 啟動 Jupyter 服務器

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

⚠️ 重要提示

將 MY_TOKEN 替換為您喜歡的認證令牌，或保持原樣。

4. 如果出現 tornado.websocket.WebSocketClosedError 錯誤（適用於 Mac）

• 刪除 notebook.ipynb 文件
• 在 Jupyter 服務器中創建一個新的筆記本，並將其重命名為 notebook.ipynb

Docker 指令

構建 Docker 鏡像

docker build -t notebook-client .

運行客戶端容器 --> 僅用於測試，不需要用於 mcp

docker run \
  -e NOTEBOOK_PATH="notebook.ipynb" \
  -e SERVER_URL="http://host.docker.internal:8888" \
  -e TOKEN="MY_TOKEN" \
  notebook-client

⚠️ 重要提示

當從不同目錄運行時，請使用完整路徑到您的筆記本文件。

Claude 桌面集成

將此配置添加到您的 Claude 桌面 config.json 文件中：

"jupyter": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-e", "NOTEBOOK_PATH=notebook.ipynb",
      "-e", "SERVER_URL=http://host.docker.internal:8888",
      "-e", "TOKEN=MY_TOKEN",
      "notebook-client"
    ]
}

⚠️ 重要提示

無需更新筆記本路徑

💡 使用建議

故障排除

• 確保 Jupyter 服務器在連接客戶端之前正在運行。
• 驗證服務器和客戶端配置中的令牌是否匹配。
• Windows 路徑在 Docker 中，請使用雙反斜槓，如示例所示。