vscode-notebook-mcp

Eine VS Code-Erweiterung, die die Jupyter-Notebooks in Ihrem VS Code-Editor für MCP-kompatible KI-Agenten (z. B. Claude Code) bereitstellt. Der Agent liest, bearbeitet und führt Zellen mit demselben Kernel aus, den auch VS Code verwendet.

Status: Pre-Alpha, Einzelentwickler-Projekt. Von Grund auf neu erstellt; kein Fork.

Tools (12)

Erkennung

Zellmanipulation

Ausführung

Kernel

Alle Tools akzeptieren eine optionale notebook_uri (wenn weggelassen → wird das aktive Notebook verwendet) und ein response_format ("markdown" oder "json").

Related MCP server: lsp-mcp

Einrichtung

1. Installieren Sie die Jupyter-Erweiterung in VS Code, falls noch nicht geschehen.

2. Erstellen und starten Sie diese Erweiterung:

   npm install
   npm run build

   Öffnen Sie dann diesen Ordner in VS Code und drücken Sie F5, um einen Extension Development Host mit geladener Erweiterung zu starten.

3. Fügen Sie dies Ihrer MCP-Client-Konfiguration hinzu:

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

4. Öffnen Sie eine .ipynb-Datei im Extension Development Host. Achten Sie auf die 🪐 :49777-Anzeige in der Statusleiste.

Konfiguration

Befehle

• Notebook MCP: Restart Server

• Notebook MCP: Show Server Info

Architektur

┌─────────────────────────────────────────────────────────┐
│                    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.) │
                └───────────────────────────────┘

Implementierungshinweise

• Schreibvorgänge erfolgen über vscode.NotebookEdit + vscode.WorkspaceEdit, wodurch Rückgängig/Wiederherstellen erhalten bleibt.

• Ausführung sendet notebook.cell.execute und wartet durch Abfragen von cell.executionSummary.success auf einen boolean-Wert (VS Code erstellt die Zusammenfassung, sobald die Ausführung beginnt, aber success wird erst dann zu einem boolean, wenn der Kernel fertig ist).

• Eingefügte Zellen werden mit einer Metadaten-ID markiert, damit der Executor sie wiederfinden kann, nachdem sich der Index durch andere gleichzeitige Bearbeitungen verschoben hat.

• Multi-Notebook: Jedes Tool akzeptiert notebook_uri. Auflösung: explizite URI → Suche in vscode.workspace.notebookDocuments (oder öffnen); andernfalls Rückgriff auf vscode.window.activeNotebookEditor.

Entwicklung

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

Drücken Sie F5 in VS Code, um den Extension Development Host zu starten.

Referenzen

Andere Projekte, die in eine ähnliche Richtung gehen:

• datalayer/jupyter-mcp-server — MCP-Server, der über HTTP/WebSocket mit einem laufenden Jupyter-Server kommuniziert.

• olavocarvalho/vscode-runtime-notebook-mcp — ähnliche Architektur wie dieses Projekt (VS Code Notebook API + eingebetteter HTTP-MCP-Server).

Ich habe dies von Grund auf neu erstellt, um zu lernen und Spielraum für Designanpassungen und die Entwicklung neuer Funktionen zu haben.

Lizenz

MIT