Merge pull request #7 from block/damien/notebook-bug

Damien/notebook bug

Author: damienrj

Justfile

@@ -1,5 +1,5 @@
 # Run all CI checks locally (matches GitHub Actions)
-ci: test lint format
+ci: test lint format build
     @echo "✅ All CI checks passed!"
 
 # Run tests (matches: uv run pytest tests)
@@ -15,4 +15,9 @@ lint:
 # Run format check and fix (matches: uvx ruff format --check but also fixes)
 format:
     @echo "🎨 Checking and fixing formatting..."
-    uvx ruff format
+    uvx ruff format
+
+# Build documentation (matches: pnpm build in docs/)
+build:
+    @echo "📚 Building documentation..."
+    cd docs && pnpm start

README.md

@@ -1,5 +1,7 @@
 # Jupyter MCP Server
 
+> **⚠️ API Compatibility Notice**: This project is currently focused on MCP (Model Context Protocol) usage. There are **no API compatibility guarantees** between versions as the interface is actively evolving. Breaking changes may occur in any release.
+
 Jupyter MCP Server allows you to use tools like [Goose](https://block.github.io/goose/) or Cursor to pair with you in a JupyterLab notebook where the state of your variables, etc is preserved by the JupyterLab Kernel.  The fact that state is preserved is the key to this because it allows to to pair with the Agent in a notebook, where for example if a package is not installed it will see the error and install it for you.   You as the user can then do some data exploration and then hand off to the agent at any time to pick up where you left off.
 
 ## Key Features

docs/docs/intro.md

@@ -5,6 +5,10 @@ slug: /
 
 # Introduction
 
+:::warning API Compatibility Notice
+This project is currently focused on MCP (Model Context Protocol) usage. There are **no API compatibility guarantees** between versions as the interface is actively evolving. Breaking changes may occur in any release.
+:::
+
 MCP Jupyter Server allows you to use AI assistants like [Goose](https://block.github.io/goose/) or Cursor to pair with you in JupyterLab notebooks where the state of your variables is preserved by the JupyterLab Kernel.
 
 ## Why MCP Jupyter?

docs/package.json

@@ -44,5 +44,11 @@
   },
   "engines": {
     "node": ">=18.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "undici": "5.28.4",
+      "jiti": "1.20.0"
+    }
   }
 }

docs/pnpm-lock.yaml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-jupyter"
-version = "1.2.0"
+version = "1.2.1"
 description = "MCP Jupyter"
 readme = "README.md"
 requires-python = ">=3.10"

pyproject.toml

@@ -57,15 +57,12 @@ def check_notebook_exists(notebook_path: str, server_url: str, token: str) -> bo
         return False
 
 
-def create_new_notebook(
-    notebook_path: str, cells: List[str], server_url: str, token: str
-) -> None:
-    """Create a new Jupyter notebook.
+def create_new_notebook(notebook_path: str, server_url: str, token: str) -> None:
+    """Create a new empty Jupyter notebook.
 
     Args:
         notebook_path: Path where to create the notebook, relative to Jupyter server root.
                        Intermediate directories will be created if they don't exist.
-        cells: List of cell contents to add
         server_url: Jupyter server URL
         token: Authentication token
 
@@ -135,18 +132,7 @@ def create_new_notebook(
         },
     }
 
-    # Add any specified cells
-    if cells:
-        for cell_content in cells:
-            notebook_content["content"]["cells"].append(
-                {
-                    "cell_type": "code",
-                    "metadata": {},
-                    "source": cell_content,
-                    "execution_count": None,
-                    "outputs": [],
-                }
-            )
+    # Notebook starts empty - use modify_notebook_cells to add content
 
     # Make the API request to create the notebook
     try:
@@ -307,15 +293,16 @@ def get_notebook_info(
 
 def prepare_notebook(
     notebook_path: str,
-    cells: Optional[List[str]] = None,
     server_url: str = "http://localhost:8888",
     token: str = None,
 ) -> Dict[str, Any]:
     """Prepare notebook for use and start kernel.
 
+    Creates an empty notebook if it doesn't exist. To add content, use the
+    modify_notebook_cells operations after creation.
+
     Args:
         notebook_path: Path to the notebook, relative to Jupyter server root
-        cells: List of cell contents (optional)
         server_url: Jupyter server URL
         token: Authentication token (defaults to env var)
 
@@ -338,7 +325,7 @@ def prepare_notebook(
 
         # Create notebook if it doesn't exist
         if not notebook_exists:
-            create_new_notebook(notebook_path, cells or [], server_url, token)
+            create_new_notebook(notebook_path, server_url, token)
             notebook_created = True
         else:
             notebook_created = False