9b-e5acb70cd9d66ddf.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","4902","static/chunks/4902-40271c136eb736f1.js","1508","static/chunks/1508-abbc58115cbb4fd0.js","6125","static/chunks/6125-6f7cbc86df4f2503.js","7771","static/chunks/7771-66979ce602088329.js","7660","static/chunks/7660-f5d56ac6a9ee6cc8.js","4147","static/chunks/4147-ef3df161a800b88b.js","9783","static/chunks/9783-e1d5b54e9718b38b.js","8084","static/chunks/8084-f1229cc5d0501fe0.js","2024","static/chunks/2024-e03e13f5faa34f45.js","7796","static/chunks/app/%5Blocale%5D/(default)/server/%5Bname%5D/%5Bauthor_name%5D/page-c3a3facf548ee943.js"],"default"] 24:T2423,

Python Notebook MCP

MCP server enabling AI assistants to interact with Jupyter notebooks through the Model Context Protocol.

This server allows compatible AI assistants (like Cursor or Claude Desktop) to interact with Jupyter Notebook files (.ipynb) on your local machine. ## 📋 Prerequisites Before you begin, ensure you have the following installed: 1. **Python:** Version 3.10 or higher. 2. **`uv`:** The fast Python package installer and virtual environment manager from Astral. If you don't have it, install it: ```bash # On macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh # On Windows (PowerShell) powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # IMPORTANT: Add uv to your PATH if prompted by the installer # For macOS/Linux (bash/zsh), add to your ~/.zshrc or ~/.bashrc: # export PATH="$HOME/.local/bin:$PATH" # Then restart your shell or run `source ~/.zshrc` (or equivalent) ``` 3. **`fastmcp` CLI (Optional, for Claude Desktop `fastmcp install`):** If you plan to use the `fastmcp install` method for Claude Desktop, you need the `fastmcp` command available. ```bash # Using uv uv pip install fastmcp # Or using pipx (recommended for CLI tools) pipx install fastmcp ``` ## 🔧 Setup 1. **Clone the Repository:** ```bash git clone https://github.com/UsamaK98/python-notebook-mcp.git # Or your fork/local path cd python-notebook-mcp ``` 2. **Choose Setup Method:** * **Option A: Automated Setup (Recommended)** Run the appropriate script for your OS from the project's root directory (where you just `cd`-ed into). * **macOS / Linux:** ```bash # Make script executable (if needed) chmod +x ./install_unix.sh # Run the script bash ./install_unix.sh ``` * **Windows (PowerShell):** ```powershell # You might need to adjust PowerShell execution policy first # Set-ExecutionPolicy RemoteSigned -Scope CurrentUser .\install_windows.ps1 ``` These scripts will create the `.venv`, install dependencies, and output the exact paths needed for your MCP client configuration. * **Option B: Manual Setup** Follow these steps if you prefer manual control or encounter issues with the scripts. 1. **Create & Activate Virtual Environment:** ```bash # Create the environment (e.g., named .venv) uv venv # Activate the environment # On macOS/Linux (bash/zsh): source .venv/bin/activate # On Windows (Command Prompt): # .venv\Scripts\activate.bat # On Windows (PowerShell): # .venv\Scripts\Activate.ps1 ``` *(You should see `(.venv)` or similar at the start of your shell prompt)* 2. **Install Dependencies:** ```bash # Make

Python notebook

Comments