Skip to content

Commit 0ba7a78

Browse files
committed
docs: Added 0.3.0 video update to README, edited cursor_rules.md
1 parent 3981c29 commit 0ba7a78

File tree

2 files changed

+20
-8
lines changed

2 files changed

+20
-8
lines changed

README.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,28 +4,36 @@
44

55
This directory contains a Model Context Protocol (MCP) server designed to allow AI agents **within Cursor** to interact with Jupyter Notebook (`.ipynb`) files. It was created to overcome a limitation with Cursor. As of version 0.50.5, in Agent mode, the model could not edit notebooks or notebook cells in response to dialog in the AI chat pane. This provides the agent with a suite of MCP tools that allow direct notebook cell manipulation.
66

7-
I'm sure at some point this will be handled natively by Cursor, but I have a data science background, and I live in Jupyter notebooks. I got tired of copy/paste-ing output of the chat manually into the notebook cells.
8-
97
Although designed to overcome a limitation with Cursor, this MCP server does not have anything specific to Cursor other than the configuration instructions. You could easily configure this for use with VS Code (Insiders) or Claude Code or any model/agent that can take advantage of MCP. Note that VS Code (Insiders) has pretty good Jupyter Notebook support now.
108

119
This MCP server uses the `nbformat` library to safely manipulate notebook structures and enforces security by restricting operations to user-defined directories. It also uses `nbconvert` to enable exporting notebooks to various formats like Python scripts, HTML, and more. The server handles all notebook operations through a clean API that maintains notebook integrity and prevents malformed changes.
1210

11+
## Latest Version
12+
13+
**Current Version:** `0.3.0` - See the [CHANGELOG.md](CHANGELOG.md) for details on recent changes. Key additions include SFTP support, Streamable HTTP transport, and new tools like `notebook_edit_cell_output`, `notebook_bulk_add_cells`, and `notebook_get_server_path_context` to improve notebook editing and path handling.
14+
1315
## Video Walkthrough
1416

17+
### [Notebook MCP Server 0.3.0 Update](https://youtu.be/R3TGyuej-IM) (YouTube)
18+
19+
[![Latest Version Thumbnail](https://img.youtube.com/vi/R3TGyuej-IM/maxresdefault.jpg)](https://youtu.be/R3TGyuej-IM)
20+
21+
* Updates in the **0.3.0 release**, overview of new tools
22+
* FastMCP upgrade with **streamable HTTP transport**
23+
* **SFTP support** for editing Jupyter notebooks on remote SSH servers,
24+
* Issue resolution (#2, #4, #5) plus known issues (#1, #3)
25+
26+
### [Overview of Notebook MCP Server](https://youtu.be/VOVMH-tle14) (YouTube)
27+
1528
[![Video Walkthrough Thumbnail](https://img.youtube.com/vi/VOVMH-tle14/maxresdefault.jpg)](https://youtu.be/VOVMH-tle14)
1629

17-
[Cursor Jupyter Notebook MCP Server](https://youtu.be/VOVMH-tle14) (YouTube) walks through:
1830
- The current **limitations** of editing notebooks directly in Cursor.
1931
- **Installing** and **configuring** the Notebook MCP Server.
2032
- **Creating a notebook** from scratch (example shown: Singular Value Decomposition tutorial in less than 2 minutes).
2133
- Demonstrating various **editing tools** (edit, split, duplicate cells).
2234
- Reading notebook **metadata**.
2335
- **Exporting** notebooks to python
2436

25-
## Latest Version
26-
27-
**Current Version:** `0.3.0` - See the [CHANGELOG.md](CHANGELOG.md) for details on recent changes. Key additions include SFTP support, Streamable HTTP transport, and new tools like `notebook_edit_cell_output`, `notebook_bulk_add_cells`, and `notebook_get_server_path_context` to improve notebook editing and path handling.
28-
2937
## Features
3038

3139
Exposes the following MCP tools (registered under the `notebook_mcp` server):

cursor_rules.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,4 +39,8 @@
3939
7. **Cell Magics & Rich Output:**
4040
* Use `!command` for shell commands (not `%%bash`).
4141
* Matplotlib, Pandas, and HTML in markdown render correctly.
42-
* Avoid `%%writefile` and similar unsupported magics.
42+
* Avoid `%%writefile` and similar unsupported magics.
43+
44+
8. **Visibility Mode (Less Waiting):**
45+
* Optimize for visibility and transparency during long edits
46+
* Create notebooks and make edits with incremental tool calls

0 commit comments

Comments
 (0)