python-notebook-mcp

python-notebook-mcp

29

Python Notebook MCP is a server that allows AI assistants to interact with Jupyter notebooks through the Model Context Protocol. It supports executing various operations on notebooks, such as initializing a workspace and managing code cells. The project provides flexibility with both automated and manual setup options and ensures seamless client-server integration.

Python Notebook MCP

  • Description: MCP server enabling AI assistants to interact with Jupyter notebooks using the Model Context Protocol.
  • Prerequisites:
    • Python 3.10 or higher
    • uv installer
    • fastmcp CLI (optional)
  • Setup:
    • Clone the repository and choose between automated or manual setup for virtual environment and dependencies.
  • Running the Server:
    • Activate the virtual environment and run using uv run python server.py.
    • Configure mcp.json for client connections.
  • Usage: Initialize workspace and perform operations such as listing, creating, reading, and editing notebooks.
  • Available Tools: Initialize workspace, list notebooks, create, read, and edit cells, etc.
  • Development: Debug using direct execution or fastmcp dev mode.
  • License: MIT License.