vscode-notebook-mcp

Расширение для VS Code, которое предоставляет доступ к Jupyter-ноутбукам в вашем редакторе VSCode для MCP-совместимых ИИ-агентов (например, Claude Code). Агент читает, редактирует и запускает ячейки, используя то же ядро, что и VS Code.

Статус: pre-alpha, проект одного разработчика. Написан с нуля; не является форком.

Инструменты (12)

Обнаружение

Манипуляции с ячейками

Выполнение

Ядро

Все инструменты принимают опциональный параметр notebook_uri (если опущен → используется активный редактор ноутбука) и response_format ("markdown" или "json").

Related MCP server: lsp-mcp

Настройка

1. Установите расширение Jupyter в VS Code, если оно еще не установлено.

2. Соберите и запустите это расширение:

   npm install
   npm run build

   Затем откройте эту папку в VS Code и нажмите F5, чтобы запустить хост разработки расширений с загруженным расширением.

3. Добавьте в конфигурацию вашего MCP-клиента:

   {
     "mcpServers": {
       "notebook": {
         "url": "http://127.0.0.1:49777/mcp"
       }
     }
   }

4. Откройте файл .ipynb в хосте разработки расширений. Ищите индикатор 🪐 :49777 в строке состояния.

Конфигурация

Команды

• Notebook MCP: Restart Server

• Notebook MCP: Show Server Info

Архитектура

┌─────────────────────────────────────────────────────────┐
│                    VS Code window                       │
│                                                         │
│  ┌───────────────────────────────────────────────────┐  │
│  │  Jupyter extension (ms-toolsai.jupyter)           │  │
│  │                                                   │  │
│  │  Notebook document  ◄──►  Kernel  ──►  Outputs    │  │
│  └───────────────────────────────────────────────────┘  │
│                          ▲                              │
│                          │ vscode.NotebookEdit,         │
│                          │ notebook.cell.execute,       │
│                          │ jupyter.kernels.getKernel    │
│                          │                              │
│  ┌───────────────────────┴───────────────────────────┐  │
│  │  This extension                                   │  │
│  │                                                   │  │
│  │   HTTP server :49777  ──►  MCP tools (12)         │  │
│  │   (StreamableHTTPServerTransport)                 │  │
│  └───────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘
                              │ HTTP (MCP protocol)
                              ▼
                ┌───────────────────────────────┐
                │   AI agent                    │
                │   (Claude Code, Cursor, etc.) │
                └───────────────────────────────┘

Примечания по реализации

• Запись выполняется через vscode.NotebookEdit + vscode.WorkspaceEdit, сохраняя историю отмены/повтора (undo/redo).

• Выполнение отправляет команду notebook.cell.execute и ожидает, опрашивая cell.executionSummary.success на наличие значения boolean (VS Code создает сводку сразу после начала выполнения, но success становится логическим значением только после завершения работы ядра).

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

• Мульти-ноутбук: каждый инструмент принимает notebook_uri. Разрешение: явный URI → поиск в vscode.workspace.notebookDocuments (или открытие); в противном случае — возврат к vscode.window.activeNotebookEditor.

Разработка

npm install
npm run build       # esbuild bundle
npm run watch       # rebuild on change
npm run typecheck   # tsc --noEmit
npm test            # vitest (no tests yet)

Нажмите F5 в VS Code, чтобы запустить хост разработки расширений.

Ссылки

Другие проекты, похожие на этот:

• datalayer/jupyter-mcp-server — MCP-сервер, который взаимодействует с запущенным сервером Jupyter через HTTP/WebSocket.

• olavocarvalho/vscode-runtime-notebook-mcp — архитектура, аналогичная этому проекту (API ноутбуков VS Code + встроенный HTTP MCP-сервер).

Я создал этот проект с нуля, чтобы изучить возможности, иметь пространство для настройки дизайна и разработки новых функций.

Лицензия

MIT