Для чего этот сервер?

Сервер подключает Claude AI к Jupyter Notebook, чтобы нейросеть напрямую управляла кодом и ячейками. Вместо ручного копирования и вставки результатов пользователь просто просит Claude выполнить анализ, построить график или обработать данные — всё происходит прямо в ноутбуке. Это ускоряет работу с данными и делает взаимодействие с AI более естественным и продуктивным.

Каталог MCP
jjsantos01/jupyter-notebook-mcp

jjsantos01/jupyter-notebook-mcp

от jjsantos01

JupyterMCP - MCP-сервер, подключающий Claude AI к Jupyter Notebook (только v6.x). Claude выполняет Python-код, управляет ячейками, анализирует данные и строит графики. Полезен для AI-ассистированно...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

JupyterMCP - Jupyter Notebook Model Context Protocol Integration

JupyterMCP connects Jupyter Notebook to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Jupyter Notebooks. This integration enables AI-assisted code execution, data analysis, visualization, and more.

⚠️ Compatibility Warning

This tool is compatible ONLY with Jupyter Notebook version 6.x.

It does NOT work with:

Jupyter Lab
Jupyter Notebook v7.x
VS Code Notebooks
Google Colab
Any other notebook interfaces

Features

Two-way communication: Connect Claude AI to Jupyter Notebook through a WebSocket-based server
Cell manipulation: Insert, execute, and manage notebook cells
Notebook management: Save notebooks and retrieve notebook information
Cell execution: Run specific cells or execute all cells in a notebook
Output retrieval: Get output content from executed cells with text limitation options

Components

The system consists of three main components:

WebSocket Server (jupyter_ws_server.py): Sets up a WebSocket server inside Jupyter that bridges communication between notebook and external clients
Client JavaScript (client.js): Runs in the notebook to handle operations (inserting cells, executing code, etc.)
MCP Server (jupyter_mcp_server.py): Implements the Model Context Protocol and connects to the WebSocket server

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить jjsantos01/jupyter-notebook-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"jjsantos01-jupyter-notebook-mcp-i0bjebof6e\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src\",\"run\",\"jupyter_mcp_server.py\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add jjsantos01-jupyter-notebook-mcp-i0bjebof6e -- uv --directory /ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src run jupyter_mcp_server.py

Либо через JSON-конфиг:

claude mcp add-json jjsantos01-jupyter-notebook-mcp-i0bjebof6e "{\"command\":\"uv\",\"args\":[\"--directory\",\"/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src\",\"run\",\"jupyter_mcp_server.py\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add jjsantos01-jupyter-notebook-mcp-i0bjebof6e -- uv --directory /ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src run jupyter_mcp_server.py

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.jjsantos01-jupyter-notebook-mcp-i0bjebof6e]
command = "uv"
args = ["--directory", "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src", "run", "jupyter_mcp_server.py"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите jjsantos01/jupyter-notebook-mcp, а в поле команды запуска — строку ниже:

uv --directory /ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src run jupyter_mcp_server.py

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например jjsantos01-jupyter-notebook-mcp-i0bjebof6e.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: jjsantos01-jupyter-notebook-mcp-i0bjebof6e
    command: uv
    args:
      - "--directory"
      - "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src"
      - "run"
      - "jupyter_mcp_server.py"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "jjsantos01-jupyter-notebook-mcp-i0bjebof6e": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
        "run",
        "jupyter_mcp_server.py"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "--directory",
    "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
    "run",
    "jupyter_mcp_server.py"
  ]
}

Информация о сервере

Номер в рейтинге: #175
Звезд на Github: 128
Форков на Github: 26
Язык реализации: Jupyter Notebook
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 18.10 в 03:47
Идентификатор: ntY821lDiQFJ7ZNp
Категории: Выполнение кода, Инструменты для разработчиков

Похожие MCP-сервера

datalayer/jupyter-mcp-server

официальный

от datalayer

Управляет Jupyter Notebook в реальном времени: выполняет ячейки, читает и редактирует код, переключается между блокнотами. Поддерживает изображения и графики.

yanmxa/scriptflow-mcp

от yanmxa

MCP-сервер для превращения сложных AI-диалогов в готовые скрипты, которые можно выполнять, версионировать и переиспользовать. Поддерживает Python, Bash, Node.js. Управляй библиотекой автономных сце...

yepcode/mcp-server-js

официальный

от yepcode

YepCode MCP сервер превращает YepCode-процессы в готовые инструменты для ИИ-ассистентов. Он запускает скрипты на Python или Node.js в изолированной среде, управляет параметрами через JSON Schema. Идеально для интеграции AI с бизнес-логикой — от выполнения кода до управления API.

alfonsograziano/node-code-sandbox-mcp

от alfonsograziano

Выполняет Node.js-код в изолированном Docker-контейнере: ставит npm-пакеты, запускает shell-команды и возвращает вывод.

yusong652/yade-mcp

от yusong652

MCP инструмент для подключения AI-агентов к YADE - DEM движку. Через естественный язык просматривайте API, запускайте симуляции и выполняйте код в консоли. Для инженеров и исследователей, автоматиз...

maxim-saplin/mcp_safe_local_python_executor

от maxim-saplin

MCP сервер для безопасного локального выполнения Python кода от LLM. Основан на LocalPythonExecutor от Hugging Face, не требует Docker, ограничивает импорты и файловые операции. Запускается через uv - замена Code Interpreter для Claude Desktop и MCP клиентов.