mcp-registry/jupyter-notebook-mcp


    ==================
      
       /// MCP ///
      /// JUP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

jupyter-notebook-mcp

by jjsantos01

A Model Context Protocol (MCP) server that lets Claude AI remotely read, edit and execute Jupyter Notebook (6.x) sessions via a WebSocket bridge.

Open Source

Installation

1. Prerequisites

• Python 3.9+ and pip installed

• Jupyter Notebook or JupyterLab already available on the system

2. Clone the repository

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

3. Create and activate a virtual environment (recommended)

   python -m venv .venv
   source .venv/bin/activate   # Windows: .venv\Scripts\activate

4. Install Python dependencies

pip install -r requirements.txt

If no requirements.txt is provided, install Jupyter and any listed packages manually.

5. Enable the MCP notebook extension (if applicable)

   jupyter nbextension install src/extension --user
   jupyter nbextension enable mcp_extension/main --user

Adjust the path/extension-name to match the code in the repo.

6. Start Jupyter and test

jupyter notebook

Open one of the sample notebooks in the repo and confirm that the MCP toolbar or menu entries appear.

Optional: Installing system-wide with pip

pip install git+https://github.com/jjsantos01/jupyter-notebook-mcp.git

License: MIT License

Updated 7/30/2025