JupyterMCP - Jupyter Notebook Model Context Protocol Integration

Name: JupyterMCP - Jupyter Notebook Model Context Protocol Integration
Author: jjsantos01

@jjsantos01

代码仓库

关于 JupyterMCP - Jupyter Notebook Model Context Protocol Integration

A Model Context Protocol (MCP) for Jupyter Notebook

基本信息

分类

记忆与知识

许可证

MIT

运行时

jupyter notebook

传输方式

stdio

发布者

jjsantos01

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "jupyter-notebook-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "-m",
        "ipykernel",
        "install",
        "--name",
        "jupyter-mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is JupyterMCP?

JupyterMCP connects Jupyter Notebook (version 6.x) to Claude AI through the Model Context Protocol (MCP). It enables Claude to directly interact with and control Jupyter Notebooks for AI-assisted code execution, data analysis, and visualization.

How to use JupyterMCP?

Install Python 3.12+, the uv package manager, and the Claude desktop app. Clone the repository, create a virtual environment with uv run python -m ipykernel install --name jupyter-mcp, then configure Claude’s claude_desktop_config.json to point to the MCP server script. Start Jupyter with uv run jupyter nbclassic, create a new notebook with the jupyter-mcp kernel, and run setup_jupyter_mcp_integration() in a cell to start the WebSocket server. Claude then gains access to tools like insert_and_execute_cell, save_notebook, run_all_cells, and more.

Key features of JupyterMCP

Two‑way communication between Claude and Jupyter Notebook via WebSocket.
Insert, execute, and manage notebook cells.
Save notebooks and retrieve notebook information.
Run specific cells or all cells in a notebook.
Retrieve text and image output from executed cells.
Edit cell content and set slideshow types.

Use cases of JupyterMCP

Create interactive presentations with mixed markdown and code cells using Claude.
Perform data analysis and visualization with Python libraries (e.g., Seaborn) under AI guidance.
Run Stata exercises directly from Claude, including code execution and output interpretation.
Automate notebook workflows such as batch cell execution and output collection.

FAQ from JupyterMCP

What versions of Jupyter does JupyterMCP support?

Only Jupyter Notebook 6.x. It does not work with Jupyter Lab, Jupyter Notebook v7.x, VS Code Notebooks, or Google Colab.

What are the system requirements?

Python 3.12 or newer, the uv package manager, and the Claude desktop application. Earlier Python versions may work but are not tested.

How does data flow in JupyterMCP?

A WebSocket server runs inside the Jupyter notebook, bridging communication between the notebook and an external MCP server that Claude connects to. Client JavaScript handles cell operations.

What are the main limitations?

Only Jupyter Notebook 6.x is supported. Text output from cells is limited to 1500 characters by default. Advanced Jupyter widget interactions are not supported. Connections may timeout after inactivity.

Is JupyterMCP compatible with Jupyter Lab?

No. It is explicitly incompatible with Jupyter Lab and all other notebook interfaces beyond Jupyter Notebook 6.x.

记忆与知识分类下的更多 MCP 服务器

Obsidian MCP Server

cyanheads

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.

618

Notion MCP Integration

danhilse

A simple MCP integration that allows Claude to read and manage a personal Notion todo list

208

Solomd

zhitongblog

A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.

425

Anytype MCP Server

anyproto

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

467

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871