@fre4x/jupyter 1.0.45
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -0
- package/dist/index.js +30537 -0
- package/package.json +35 -0
package/README.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# @fre4x/jupyter
|
|
2
|
+
|
|
3
|
+
Jupyter Notebook MCP server for reading, writing, and executing code in `.ipynb` files.
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- **Read/Write**: Full support for `.ipynb` (JSON) manipulation.
|
|
8
|
+
- **Execute**: Run code cells in Jupyter kernels in mock mode; real kernel execution is not yet implemented.
|
|
9
|
+
- **Control**: List kernels and open notebooks in the browser. Kernel listing is mock-only for now.
|
|
10
|
+
- **Mock Mode**: Development without a real Jupyter server using `MOCK=true`.
|
|
11
|
+
|
|
12
|
+
## Tools
|
|
13
|
+
|
|
14
|
+
- `jupyter_get_notebook`: Read a Jupyter notebook (.ipynb) file.
|
|
15
|
+
- `jupyter_create_notebook`: Create a new empty Jupyter notebook.
|
|
16
|
+
- `jupyter_add_cell`: Add a new cell (code/markdown) to a notebook.
|
|
17
|
+
- `jupyter_update_cell`: Update the content of an existing cell.
|
|
18
|
+
- `jupyter_execute_code`: Execute code in a Jupyter kernel (mock mode only).
|
|
19
|
+
- `jupyter_list_kernels`: List all active Jupyter kernels (mock mode only).
|
|
20
|
+
- `jupyter_open_notebook`: Open a notebook in the default browser or viewer.
|
|
21
|
+
|
|
22
|
+
## Usage
|
|
23
|
+
|
|
24
|
+
### Mock Mode
|
|
25
|
+
```bash
|
|
26
|
+
MOCK=true npx @fre4x/jupyter
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### Claude Desktop Configuration
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"jupyter": {
|
|
34
|
+
"command": "npx",
|
|
35
|
+
"args": ["-y", "@fre4x/jupyter"],
|
|
36
|
+
"env": {
|
|
37
|
+
"JUPYTER_SERVER_URL": "http://localhost:8888"
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Requirements
|
|
45
|
+
|
|
46
|
+
- Node.js 18+
|
|
47
|
+
- (Optional) A running Jupyter Server for non-mock execution.
|