jjsantos01/jupyter-notebook-mcp logo

jjsantos01/jupyter-notebook-mcp

Free

将 Jupyter Notebook 连接到 Claude AI,允许 Claude 直接交互和控制 Jupyter。

FreeFree tier
Type
Open Source

About jjsantos01/jupyter-notebook-mcp

JupyterMCP is an open-source integration that connects Jupyter Notebook (version 6.x) to Claude AI via the Model Context Protocol (MCP). It allows Claude to directly interact with and control Jupyter Notebooks, enabling AI-assisted code execution, data analysis, and visualization. The tool consists of three components: a WebSocket server that bridges communication, a client JavaScript that handles notebook operations, and an MCP server implementing the protocol. It supports two-way communication, cell manipulation (insert, execute, manage), notebook saving and retrieval, cell execution (specific or all), and output retrieval with text limitation options. Note: This tool is only compatible with Jupyter Notebook 6.x and does not work with Jupyter Lab, Notebook v7, VS Code, or Google Colab.

Key Features

Two-way communication between Claude AI and Jupyter Notebook through a WebSocket-based server
Insert, execute, and manage notebook cells
Save notebooks and retrieve notebook information
Run specific cells or execute all cells in a notebook
Get output content from executed cells with text limitation options

Pros & Cons

Pros
  • Enables direct AI control of Jupyter Notebooks for interactive development
  • Open source and free to use
  • Granular cell-level operations (insert, execute, retrieve output)
  • WebSocket-based real-time communication for low-latency interaction
Cons
  • Only compatible with Jupyter Notebook 6.x (not Jupyter Lab, Notebook v7, VS Code, or Google Colab)
  • Requires manual setup with uv package manager and Claude desktop configuration
  • Limited to Claude AI integration; not designed for other AI assistants

Best For

AI-assisted code execution in Jupyter NotebooksAutomated data analysis and visualization workflowsRemote control and manipulation of Jupyter Notebooks via Claude AI

FAQ

Which Jupyter versions are compatible with JupyterMCP?
Only Jupyter Notebook version 6.x is supported. It does not work with Jupyter Lab, Jupyter Notebook v7.x, VS Code Notebooks, or Google Colab.
What is the Model Context Protocol (MCP)?
MCP is a standard protocol that connects AI assistants (like Claude) to tools and data sources, enabling structured interaction.
What are the prerequisites for using JupyterMCP?
You need Python 3.12 or newer, the uv package manager, and the Claude AI desktop application.