Jupyter_MCP_Server

Name: Jupyter_MCP_Server
Author: shreyu258

本地服务

github.com/shreyu258数据与分析081 周前更新

关于 Jupyter_MCP_Server

JupyterMCP 通过 MCP 将 Jupyter Notebook 连接到 Claude，适用于在笔记本中编写代码和分析数据。它支持客户端编辑、执行单元格，管理笔记本并读取文本或图像输出。

MCP 服务通过 WebSocket 服务连接客户端与 Jupyter Notebook。它提供单元格执行和编辑、笔记本管理及输出读取工具。

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

JupyterMCP 通过模型上下文协议（MCP）将 Jupyter Notebook 连接到 Claude AI，让 Claude 能够直接与 Jupyter Notebook 交互并对其进行控制。此集成支持 AI 辅助代码执行、数据分析、可视化等功能。

系统由三个主要组件组成：

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"

其他平台请参阅 uv 安装指南。

将此仓库克隆或下载到你的计算机：

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 文件夹的实际路径。例如：
- Windows："C:\\Users\\MyUser\\GitHub\\jupyter-notebook-mcp\\src\\"
- Mac：/Users/MyUser/GitHub/jupyter-notebook-mcp/src/
如果之前已打开 Claude，请依次选择 File > Exit，然后重新打开。

启动 Jupyter Notebook（6.x 版本）服务：
```
uv run jupyter nbclassic
```
创建一个新的 Jupyter Notebook，并确保选择 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 文件夹路径。例如：
- Windows："C:\\Users\\MyUser\\GitHub\\jupyter-notebook-mcp\\src\\"
- Mac：/Users/MyUser/GitHub/jupyter-notebook-mcp/src/
启动已启用 MCP 的 Claude 桌面应用。