jupyter MCP server kshitij

Jupyter MCP服务器客户端

此存储库包含一个基于Docker的客户端，用于连接到支持多协作协议的Jupyter服务器。 适用于claude桌面上的windows和mac

先决条件

• Python 3.12.10
• 码头工人
• Git

安装说明

1.设置Python环境

# Create and activate virtual environment
python3.12 -m venv env
source env/bin/activate  # Windows: env\Scripts\activate

# Install package manager
pip install uv

# Install required packages
uv pip install jupyterlab jupyter-collaboration ipykernel pycrdt
uv pip install jupyter-nbmodel-client jupyter_kernel_client

# Fix dependencies (required for compatibility)
pip uninstall -y jupyter_server_ydoc pycrdt
uv pip install jupyter_server_ydoc pycrdt

2.创建笔记本

# Clone the repository -> Required
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 --no-browser

然后手动转到http://localhost:8888

注： 替换 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服务器正在运行
• 验证您的令牌在服务器和客户端配置之间是否匹配
• 对于Docker中的Windows路径，使用双反斜杠，如示例所示
• 记得打开http://localhost:8888/lab这个url除了这个之外什么都不起作用