Python notebook

Позволяет AI-ассистентам создавать, редактировать и просматривать Jupyter notebooks локально через Model Context Protocol.

Python

⭐ 39 stars

Описание

Легковесный сервер на Python для интеграции AI-ассистентов (типа Cursor или Claude Desktop) с Jupyter notebooks (.ipynb). Ключевые особенности: инициализация рабочего пространства, создание/чтение/редактирование ячеек, управление выводами. Технологии: Python 3.10+, uv для установки, fastmcp для Claude. Применения: автоматизация анализа данных, экспериментов в AI-среде, локальная работа с notebooks без облака.

Возможности

✓

Инициализация рабочего пространства

Устанавливает абсолютный путь к директории с notebooks для начала работы.

✓

Список notebooks

Перечисляет все .ipynb файлы в рабочем пространстве.

✓

Создание notebook

Создает новый пустой Jupyter notebook по указанному пути.

✓

Чтение/редактирование ячеек

Читает содержимое или выводы ячеек, редактирует код/маркдаун по индексу.

✓

Добавление ячеек

Добавляет новые code или markdown ячейки в notebook.

✓

Чтение полного notebook

Загружает всю структуру и содержимое notebook.

Установка

Предварительные требования: Python 3.10+, uv (установка: curl -LsSf https://astral.sh/uv/install.sh | sh для macOS/Linux; powershell -c “irm https://astral.sh/uv/install.ps1 | iex” для Windows). Клонировать репозиторий: git clone https://github.com/UsamaK98/python-notebook-mcp.git && cd python-notebook-mcp. Автоматическая установка: bash ./install_unix.sh (macOS/Linux) или .\install_windows.ps1 (Windows). Ручная: uv venv && source .venv/bin/activate && uv pip install -r requirements.txt. Запуск: uv run python server.py. Для Claude: fastmcp install server.py –name “Jupyter Notebook MCP”.

Информация

Язык

Python

Лицензия

MIT License

GitHub Stars

Ссылки

GitHub