Commercial-grade Jupyter MCP server - Give your AI assistant superpowers with notebooks
Project description
Jupyters - AI Notebook Assistant
🎉 Let's keep Jupyter fun!
Give your AI assistant deep, semantic access to Jupyter notebooks through the Model Context Protocol (MCP).
What is Jupyters?
Jupyters is a commercial-grade MCP server that allows AI assistants (Claude, ChatGPT, Cursor, etc.) to:
- 📓 Read and write notebook cells
- ⚡ Execute code in live Jupyter kernels
- 🔍 Inspect variables with semantic understanding (DataFrames, tensors, etc.)
- 🧠 Auto-analyze errors with variable context
- 📊 Capture plots and image outputs
- 🛡️ Prevent destructive operations with safety checks
Quick Start
1. Install
pip install jupyters-server
2. Configure Your AI Tool
For Claude Desktop:
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"jupyters": {
"command": "jupyters-server"
}
}
}
For Claude Code or other MCP clients: See documentation.
3. Restart Your AI Tool
Quit and reopen Claude Desktop (or your AI client).
4. Try It!
Ask your AI:
What Jupyter tools do you have access to?
Then:
Read my notebook at /path/to/notebook.ipynb and execute the first 3 cells
Features
| Feature | Free | Pro ($9/mo) | Team ($29/mo) |
|---|---|---|---|
| Read/Write Cells | ✅ | ✅ | ✅ |
| Execute Cells | 5/day | Unlimited | Unlimited |
| Variable Inspection | ❌ | ✅ | ✅ |
| Plot/Image Capture | ❌ | ✅ | ✅ |
| Domain Profiles (ML/Finance) | ❌ | ❌ | ✅ |
| Auto-Error Analysis | ✅ | ✅ | ✅ |
| Safety Checks | ✅ | ✅ | ✅ |
MCP Tools
Jupyters provides 16 MCP tools for notebook operations:
Notebooks: read_notebook, create_notebook, read_notebook_outline
Cells: read_cell, update_cell, add_cell, split_cell, merge_cells
Execution: run_cell, restart_kernel, get_execution_order
Inspection: inspect_variable, read_variable_sample (Pro+)
Config: set_profile (Team), activate_license, get_server_info
Upgrade
Get unlimited executions and advanced features:
# Visit https://jupyters.fun/pricing to get your license key
# Then activate via your AI:
Ask your AI: "Activate my Jupyters license: CE-PRO-XXXXXXXXXX"
Documentation
- 📖 Full docs: https://jupyters.fun/docs
- 💰 Pricing: https://jupyters.fun/pricing
- 🐛 Issues: https://github.com/jupytersfun/jupyters/issues
- 💬 Support: support@jupyters.fun
Requirements
- Python 3.10+
- Jupyter kernel (ipykernel)
- MCP-compatible AI client
License
Commercial software with free tier. See pricing for details.
Let's keep Jupyter fun! 🎉
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jupyters_server-0.1.7.tar.gz.
File metadata
- Download URL: jupyters_server-0.1.7.tar.gz
- Upload date:
- Size: 27.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f30be60aa100cda4a1354c324d71ffda78db4c9d00d5a1a9d62358c964120b21
|
|
| MD5 |
99011c7da61f8f99a25b8042e66e3913
|
|
| BLAKE2b-256 |
5f144914a78664fbba158bb67934468d453b43f2bb2f78afac4a0c8b2e481f8c
|
File details
Details for the file jupyters_server-0.1.7-py3-none-any.whl.
File metadata
- Download URL: jupyters_server-0.1.7-py3-none-any.whl
- Upload date:
- Size: 26.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
36c7deab744c7d30a1f237644bec3412bf621a56a0be47cd407dc9e35e9d014a
|
|
| MD5 |
e7d08d1fafd7ac87af99468f36d80f48
|
|
| BLAKE2b-256 |
98128f5057d8000d319d27edfc941ffe0c6abf69f2b879e8c78080452c29ca95
|