Metadata-Version: 2.4
Name: notebook-mcp
Version: 1.5.4
Summary: MCP server that provides notebook-aware context and analysis for .ipynb files
License-Expression: MIT
Project-URL: Homepage, https://github.com/akram-side-projects/notebook-mcp
Project-URL: Repository, https://github.com/akram-side-projects/notebook-mcp
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: nbformat>=5.10.4
Requires-Dist: pydantic>=2.7.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: networkx>=3.3
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.2.0; extra == "dev"
Requires-Dist: ruff>=0.5.0; extra == "dev"
Requires-Dist: build>=1.2.1; extra == "dev"
Requires-Dist: twine>=5.1.0; extra == "dev"
Dynamic: license-file

# Notebook MCP

![Notebook MCP](docs/notebook-mcp-pproduct-img.png)

Notebook MCP is a Model Context Protocol (MCP) server that provides deep semantic understanding of Jupyter notebooks for AI assistants and automation workflows.

---

## 🧠 Why Notebook MCP?

Jupyter notebooks are difficult for AI assistants to reason about because they are:

* Stateful
* Non-linear
* Execution-order dependent
* Mixed with outputs and markdown

Notebook MCP solves this by building execution graphs and runtime awareness.

---

## ✨ Features

* Static notebook dependency analysis
* Execution state detection (stale / unexecuted cells)
* Rerun planning engine
* Focused notebook context generation
* Notebook to deterministic Python conversion
* Jupyter kernel runtime execution and inspection

---

## 📦 Installation

```
pip install notebook-mcp
```

---

## 🚀 Running Server

```
notebook-mcp-python
```

---

## 🔧 Environment Variables (Optional)

For Jupyter runtime integration:

```
JUPYTER_BASE_URL=http://localhost:8888
JUPYTER_TOKEN=<your_token>
```

---

## 🧪 Example Use Cases

* AI notebook debugging
* Automated notebook refactoring
* Execution dependency tracking
* Runtime variable inspection

---

## 🧩 Integration

Notebook MCP is designed to integrate with:

* AI coding assistants
* MCP clients
* Notebook automation workflows

---

## 📚 Source Code

GitHub:
[https://github.com/akram-side-projects/notebook-mcp](https://github.com/akram-side-projects/notebook-mcp)

---

## 🤝 Contributions

PRs and feedback welcome.
