使用说明

Jupyter_MCP_服务器

JupyterMCP连接 Jupyter笔记本向克劳德 AI 通过模型上下文协议（MCP），允许Claude直接与Jupyter笔记本交互和控制。这种集成实现了人工智能辅助的代码执行、数据分析、可视化等。

该系统由三个主要部分组成：

WebSocket服务器(jupyter_ws_server.py)：在Jupyter中设置一个WebSocket服务器，连接笔记本电脑和外部客户端之间的通信
客户端JavaScript(client.js)：在笔记本中运行以处理操作（插入单元格、执行代码等）
MCP服务器(jupyter_mcp_server.py)：实现模型上下文协议并连接到WebSocket服务器

如果你在Mac上：

brew install uv

在Windows（PowerShell）上：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

有关其他平台，请参阅紫外线安装指南.

克隆或下载此存储库到您的计算机：

git clone https://github.com/jjsantos01/jupyter-notebook-mcp.git

使用安装所需的软件包创建虚拟环境 jupyter-mcp 内核，这样它就可以被您的jupyter安装识别出来，如果您以前有过的话。
```
uv run python -m ipykernel install --name jupyter-mcp
```
（可选）为您的分析安装其他Python包：
```
uv pip install seaborn
```
配置Claude桌面集成：首选 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 包括以下内容：
```
   {
    "mcpServers": {
        "jupyter": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
                "run",
                "jupyter_mcp_server.py"
            ]
        }
    }
}
```
替换 /ABSOLUTE/PATH/TO/ 与实际路径 src 系统上的文件夹。例如：
- 窗户： "C:\\Users\\MyUser\\GitHub\\jupyter-notebook-mcp\\src\\"
- 雨衣： /Users/MyUser/GitHub/jupyter-notebook-mcp/src/
如果你之前打开过克劳德，那么 File > Exit 然后再打开它。

启动Jupyter Notebook（版本6.x）服务器：
```
uv run jupyter nbclassic
```
创建一个新的Jupyter记事本，并确保您选择了 jupyter-mcp 内核： kernel -> change kernel -> jupyter-mcp
在笔记本单元中，运行以下代码以初始化WebSocket服务器：
```
import sys
sys.path.append('/path/to/jupyter-notebook-mcp/src')  # Add the path to where the scripts are located

from jupyter_ws_server import setup_jupyter_mcp_integration

# Start the WebSocket server inside Jupyter
server, port = setup_jupyter_mcp_integration()
```
别忘了在这里更换 '/path/to/jupyter-notebook-mcp/src' 随着 src 系统上的文件夹。例如：
- 窗户： "C:\\Users\\MyUser\\GitHub\\jupyter-notebook-mcp\\src\\"
- 雨衣： /Users/MyUser/GitHub/jupyter-notebook-mcp/src/
启动启用MCP的Claude桌面。

连接后，Claude将可以访问以下工具：