MCP Jupyter Server

Instructions

Implementation Reference

• src/jupyter-handler.js:226-245 (handler)

  The core handler function that reads the Jupyter notebook, validates the cell index, deletes the specified cell (preventing deletion of the last cell), persists the changes, and returns a success message.

  async deleteCell(notebookPath, cellIndex) {
    const notebook = await this.readNotebook(notebookPath);
    this.validateCellIndex(notebook.cells, cellIndex);
    
    if (notebook.cells.length === 1) {
      throw new Error("Cannot delete the last remaining cell in the notebook");
    }
    
    notebook.cells.splice(cellIndex, 1);
    await this.writeNotebook(notebookPath, notebook);
    
    return {
      content: [
        {
          type: "text",
          text: `Successfully deleted cell ${cellIndex}`
        }
      ]
    };
  }

• src/index.js:122-138 (schema)

  The input schema definition for the delete_cell tool, specifying required parameters notebook_path (string) and cell_index (integer).

  {
    name: "delete_cell",
    description: "Delete a cell by index",
    inputSchema: {
      type: "object",
      properties: {
        notebook_path: {
          type: "string",
          description: "Absolute path to the Jupyter notebook file"
        },
        cell_index: {
          type: "integer",
          description: "Zero-based index of the cell to delete"
        }
      },
      required: ["notebook_path", "cell_index"]
    }

• src/index.js:352-354 (registration)

  The dispatch registration in the MCP server's CallToolRequestSchema handler that routes delete_cell calls to the JupyterHandler's deleteCell method.

  case "delete_cell":
    return await this.jupyterHandler.deleteCell(args.notebook_path, args.cell_index);