Notebook Session Labs — VS Code Extension

A local bridge for live notebook sessions inside VS Code. This extension exposes notebook operations through a secure HTTP bridge that MCP clients can connect to.

Installation

Install from the VS Code Marketplace (search for "Notebook Session Labs") or install the .vsix manually:

code --install-extension notebook-session-labs-0.1.0.vsix

Usage

Open a notebook (.ipynb) in VS Code
The bridge starts automatically and shows the port in the status bar
Configure your MCP client with the host and port values
(Optional) Enable token auth via notebookSessionLabs.bridge.authMode for stricter local security

Commands

Command	Description
`Notebook Session Labs: Start Bridge`	Start the bridge server manually
`Notebook Session Labs: Stop Bridge`	Stop the bridge server
`Notebook Session Labs: Show Bridge Status`	Display current bridge status

Configuration

Setting	Default	Description
`notebookSessionLabs.bridge.enabled`	`true`	Enable the bridge server
`notebookSessionLabs.bridge.host`	`127.0.0.1`	Bridge host address
`notebookSessionLabs.bridge.port`	`0`	Bridge port (0 = ephemeral)
`notebookSessionLabs.bridge.autoStart`	`true`	Auto-start when a notebook opens
`notebookSessionLabs.bridge.authMode`	`"none"`	Auth mode: `"none"` (default) or `"token"`
`notebookSessionLabs.logging.level`	`info`	Log level
`notebookSessionLabs.output.maxSize`	`100000`	Max output size per cell (bytes)
`notebookSessionLabs.output.includeImages`	`true`	Include image outputs

Architecture

MCP Client <--stdio--> MCP Server <--HTTP--> VS Code Extension Bridge <--API--> Notebook

The extension is the source of truth for notebook access. It uses loopback-only binding with optional token authentication.

See the root README and architecture docs for details.

Requirements

VS Code 1.90.0 or later

License

MIT

Notebook Session Labs

Creatidy