# jupyter-mcp-server

MCP-сервер подключает ИИ к Jupyter Notebook: он читает, меняет и выполняет ячейки, управляет несколькими ноутбуками и возвращает изображения.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: ChengJiale150
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ChengJiale150/jupyter-mcp-server
- Обновлён: 2025-11-01
- HTML: https://affpapa.org/nevibecode/mcp/jupyter-mcp-server

## Что делает

jupyter-mcp-server даёт агенту инструменты для работы с Jupyter Notebook: подключения и создания ноутбука, чтения исходного содержимого, просмотра и изменения ячеек, их удаления, вставки и выполнения. Есть отдельный вызов для добавления и запуска ячейки в конце ноутбука, а временный код можно выполнить без сохранения.

Сервер запускается через `uvx` и требует Python 3.12+ и `uv`. Перед работой нужно запустить Jupyter Server, получить URL и токен командой `jupyter server list`, а затем передать эти параметры в правилах или подсказке агенту. Для изображений клиент должен поддерживать мультимодальные ответы, иначе этот тип результата не отобразится.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add jupyter-mcp-server -- uvx better-jupyter-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from better-jupyter-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add jupyter-mcp-server -- uvx better-jupyter-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from better-jupyter-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jupyter-mcp-server": {
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from better-jupyter-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "jupyter-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "better-jupyter-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from better-jupyter-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add jupyter-mcp-server uvx better-jupyter-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from better-jupyter-mcp-server <команда>

## Когда брать
- подключить несколько Jupyter Notebook к агенту
- прочитать и изменить содержимое ячеек
- запустить код и получить результат ячейки
- добавить исполняемую ячейку в конец ноутбука
- проверить промежуточные значения без записи в ноутбук

## Примеры запросов агенту
- Подключись к ноутбуку проекта и выполни ячейку с расчётом сводной статистики.
- Найди ячейку с загрузкой данных, измени её и запусти повторно.
- Выполни временный код, чтобы проверить значение переменной, не сохраняя его в ноутбуке.

## Похожие
- [jupyter-notebooks](https://affpapa.org/nevibecode/plugins/jupyter-notebooks.md) — плагин · ★ 40451
- [jupyter-to-marimo](https://affpapa.org/nevibecode/skills/jupyter-to-marimo.md) — скилл · 3400 установок
- [jupyter-notebook](https://affpapa.org/nevibecode/skills/jupyter-notebook.md) — скилл · 5600 установок
- [data-analysis-jupyter](https://affpapa.org/nevibecode/skills/data-analysis-jupyter.md) — скилл · 1500 установок
- [data-jupyter-python](https://affpapa.org/nevibecode/skills/data-jupyter-python.md) — скилл · 865 установок
- [open-notebook](https://affpapa.org/nevibecode/skills/open-notebook.md) — скилл · 2000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md