vscode-notebook-mcp

Una extensión de VS Code que expone los notebooks de Jupyter en tu editor de VSCode a agentes de IA compatibles con MCP (por ejemplo, Claude Code). El agente lee, edita y ejecuta celdas utilizando el mismo kernel que usa VS Code.

Estado: pre-alfa, proyecto de un solo desarrollador. Creado desde cero; no es un fork.

Herramientas (12)

Descubrimiento

Manipulación de celdas

Ejecución

Kernel

Todas las herramientas aceptan un notebook_uri opcional (si se omite, utiliza el editor de notebook activo) y response_format ("markdown" o "json").

Related MCP server: lsp-mcp

Configuración

1. Instala la extensión de Jupyter en VS Code si aún no la tienes.

2. Compila y ejecuta esta extensión:

   npm install
   npm run build

   Luego abre esta carpeta en VS Code y presiona F5 para iniciar un Host de Desarrollo de Extensiones con la extensión cargada.

3. Añade a la configuración de tu cliente MCP:

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

4. Abre un archivo .ipynb en el Host de Desarrollo de Extensiones. Busca el indicador 🪐 :49777 en la barra de estado.

Configuración

Comandos

• Notebook MCP: Restart Server

• Notebook MCP: Show Server Info

Arquitectura

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

Notas de implementación

• Las escrituras pasan por vscode.NotebookEdit + vscode.WorkspaceEdit, preservando deshacer/rehacer.

• La ejecución envía notebook.cell.execute y espera mediante el sondeo de cell.executionSummary.success para obtener un valor boolean (VS Code crea el resumen tan pronto como comienza la ejecución, pero success solo se convierte en booleano cuando el kernel termina).

• Las celdas insertadas están etiquetadas con un id de metadatos para que el ejecutor pueda encontrarlas de nuevo después de que el índice cambie debido a otras ediciones concurrentes.

• Multi-notebook: cada herramienta acepta notebook_uri. Resolución: URI explícito → buscar en vscode.workspace.notebookDocuments (o abrirlo); de lo contrario, recurrir a vscode.window.activeNotebookEditor.

Desarrollo

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

Presiona F5 en VS Code para iniciar el Host de Desarrollo de Extensiones.

Referencias

Otros proyectos en líneas similares a este proyecto:

• datalayer/jupyter-mcp-server — Servidor MCP que se comunica con un servidor Jupyter en ejecución a través de HTTP/WebSocket.

• olavocarvalho/vscode-runtime-notebook-mcp — arquitectura similar a este proyecto (API de Notebook de VS Code + servidor MCP HTTP integrado).

He construido esto desde cero para aprender y así tener espacio para ajustar el diseño y desarrollar nuevas funciones.

Licencia

MIT