Jupyter MCP Server

Jupyter MCP Server

An MCP server enabling real-time AI interaction with Jupyter Notebooks.

787
Stars
130
Forks
7
Releases

Overview

Jupyter MCP Server is an MCP server developed for AI to connect and manage Jupyter Notebooks in real-time. It exposes a rich set of tools for notebook interaction, organized into server-management commands (list_files, list_kernels), multi-notebook operations (use_notebook, list_notebooks, restart_notebook, unuse_notebook, read_notebook), and cell-level actions (read_cell, insert_cell, delete_cell, overwrite_cell_source, execute_cell, insert_execute_code_cell, execute_code). It also provides JupyterLab integration (notebook_run-all-cells) for a seamless UI experience. The server supports multimodal outputs and can execute cells with timeouts, returning images and other content. It emphasizes context-aware interactions by considering the entire notebook context to make prompts and actions more relevant. It is MCP-compatible, enabling easy integration with any MCP client like Claude Desktop, Cursor, Windsurf, and more. It works with various Jupyter deployments (local, JupyterHub) and with Datalayer-hosted Notebooks. Deployment options include uvx for quick start and Docker for production. Documentation covers client configuration, token handling, and networking tips, along with best practices and prompt usage guidance (e.g., jupyter-cite).

Details

Owner
datalayer
Language
Python
License
BSD 3-Clause "New" or "Revised" License
Updated
2025-12-07

Features

Real-time control

Instants view of notebook changes as they happen.

Smart execution

Automatically adjusts when a cell run fails thanks to cell output feedback.

Context-aware

Understands the entire notebook context for more relevant interactions.

Multimodal support

Supports different output types, including images, plots, and text.

Multi-notebook support

Seamlessly switch between multiple notebooks.

JupyterLab integration

Enhanced UI integration like automatic notebook opening.

MCP-compatible

Works with any MCP client, such as Claude Desktop, Cursor, Windsurf, and more.

Jupyter deployment compatibility

Compatible with local, JupyterHub, and Datalayer-hosted notebooks.

Tags

MCPJupyterNotebookReal-timeMultimodalJupyterLabNotebook managementKernel executionCell operationsAI collaboration