jupyter-notebook-mcp

58

JupyterMCP integrates Jupyter Notebook with Claude AI using Model Context Protocol to facilitate AI-driven data analysis and code execution. It is compatible only with Jupyter Notebook 6.x and features WebSocket communication for efficient operations.

JupyterMCP - Jupyter Notebook Model Context Protocol Integration

JupyterMCP connects Jupyter Notebook to Claude AI through the Model Context Protocol (MCP), enabling AI-assisted code execution, data analysis, and visualization.

⚠️ Compatibility Warning

  • Compatible ONLY with Jupyter Notebook version 6.x.
  • Incompatible with Jupyter Lab, VS Code Notebooks, Google Colab, or Jupyter Notebook v7.x.

Features

  • Two-way communication between Claude AI and Jupyter Notebook via WebSocket.
  • Cell manipulation and execution.
  • Notebook management and output retrieval.

Components

  • WebSocket Server: Bridges communication between Jupyter and external clients.
  • Client JavaScript: Handles notebook operations.
  • MCP Server: Connects to WebSocket server.

Installation

  • Requires Python 3.12+, 'uv' package manager, and Claude AI desktop application.
  • Install 'uv' using platform-specific instructions.

Usage

  • Set up WebSocket server in Jupyter.
  • Launch Claude desktop with MCP enabled and perform notebook operations using Jupyter.

⚠️ DISCLAIMER

Experimental project. Use with caution.