MCP Server (TypeScript)
    │
    ├── notebook-file.ts   — read/write .ipynb files
    │
    └── kernel-exec.ts     — kernel lifecycle & execution
            │
            └── kernel_helper.py  — Python long-running process
                    │
                    └── jupyter_client (ZMQ)  — direct kernel communication

pip install jupyter_client

npm install
npm run dev       # development (tsx)
npm run build     # compile TypeScript
npm start         # production (node dist/index.js)

{
  "mcpServers": {
    "notebook-editor": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-servers/notebook-editor/src/index.ts"]
    }
  }
}

start_kernel(name="python3")           → kernel_id
execute_cell(file_path="demo.ipynb", cell_index=0, kernel_id="<id>")
shutdown_kernel(kernel_id="<id>")

start_kernel(name="python3")           → kernel_id
execute_cell(file_path="demo.ipynb", cell_index=0, kernel_id="<id>")
execute_cell(file_path="demo.ipynb", cell_index=1, kernel_id="<id>")
execute_cell(file_path="demo.ipynb", cell_index=2, kernel_id="<id>")
shutdown_kernel(kernel_id="<id>")

execute_cell(file_path="demo.ipynb", cell_index=0)
# Kernel auto-starts and shuts down after execution

npm install
npm run dev