python-notebook-mcp

概述

Python Notebook MCP是一个轻量级服务器，通过模型上下文协议(MCP)使Cursor和Claude Desktop等AI助手能够与Jupyter笔记本交互。它允许初始化工作区，然后对笔记本文件执行各种操作，包括创建、读取、编辑单元格以及访问单元格输出。该服务器文档完善，为不同操作系统提供了清晰的设置说明和多种安装方法。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• initialize_workspaceinitialize_workspace(directory: str)

  Sets the absolute path for the workspace directory.

  试试:Initialize workspace with the current directory试试:Set workspace to /home/user/projects
• list_notebookslist_notebooks()

  Lists all .ipynb files found within the workspace directory.

  试试:Show me all notebooks in the workspace试试:List available Jupyter notebooks
• create_notebookcreate_notebook(filepath: str, title: str)

  Creates a new, empty Jupyter notebook if it doesn't exist.

  试试:Create a new notebook called analysis.ipynb试试:Make a new notebook in the data folder
• read_notebookread_notebook(filepath: str)

  Reads the entire structure and content of a notebook.

  试试:Read contents of my_notebook.ipynb试试:Show me the structure of analysis.ipynb
• read_cellread_cell(filepath: str, cell_index: int)

  Reads the content and metadata of a specific cell by index.

  试试:Show me cell 0 in my_notebook.ipynb试试:Read the content of the third cell
• edit_celledit_cell(filepath: str, cell_index: int, content: str)

  Modifies the source content of an existing cell by index.

  试试:Update cell 1 with new code试试:Change cell 2 to contain markdown text
• add_celladd_cell(filepath: str, content: str, cell_type: str, index: int = null)

  Adds a new code or markdown cell at a specific index or at the end.

  试试:Add a new code cell to my_notebook.ipynb试试:Insert a markdown cell at the beginning
• read_notebook_outputsread_notebook_outputs(filepath: str)

  Reads all outputs from all code cells in a notebook.

  试试:Show me all outputs from my_notebook.ipynb试试:Display results from all code cells
• read_cell_outputread_cell_output(filepath: str, cell_index: int)

  Reads the output(s) of a specific code cell by index.

  试试:Show the output of cell 5 in analysis.ipynb试试:What did cell 3 produce when run?

可对比工具

安装

git clone https://github.com/UsamaK98/python-notebook-mcp.git
cd python-notebook-mcp

uv venv
source .venv/bin/activate  # 或Windows上的 .venv\Scripts\activate.bat

uv pip install -r requirements.txt

{
  "mcpServers": {
    "jupyter": {
      "command": "/full/path/to/.venv/bin/python",
      "args": ["/full/path/to/server.py"]
    }
  }
}

fastmcp install server.py --name "Jupyter Notebook MCP"

FAQ

连接到服务器后，我需要做的第一步是什么？

您必须使用initialize_workspace工具初始化工作区，并提供包含笔记本的项目目录的绝对路径。

我可以对笔记本文件使用相对路径吗？

不可以，服务器要求所有笔记本操作都使用绝对路径。不接受'.'这样的相对路径。

python-notebook-mcp 对比