什麼是MCP Notebooks Server?

MCP Notebooks是一個特殊的Python代碼執行環境，允許AI模型逐步執行代碼並即時查看結果。與傳統執行環境不同，它能保留變量狀態，支持交互式調試和快速修正。

如何使用MCP Notebooks?

通過Docker容器部署服務，然後在AI工具(如Claude)配置文件中添加對應的MCP服務器配置即可啟用。

適用場景

最適合需要逐步執行Python代碼並保留中間結果的AI交互場景，如數據分析演示、算法調試和教學示例等。

主要功能

漸進式執行支持分步執行代碼片段，保留變量狀態供後續使用

安全隔離推薦使用Docker容器運行，提供基礎的系統保護

擴展支持可通過Poetry靈活添加Python庫依賴

優勢與侷限性

優勢

交互式調試：AI可以逐步執行代碼並立即看到結果

狀態保留：變量在多次執行間保持存活

靈活擴展：可輕鬆添加常用數據科學庫

侷限性

當前安全隔離不足，必須依賴Docker提供基礎保護

缺少可視化界面查看筆記本內容

依賴管理需要手動操作

如何使用

安裝Docker

確保系統已安裝Docker引擎

構建鏡像

克隆倉庫並構建Docker鏡像

配置AI工具

在AI工具的配置文件中添加MCP服務器配置(選擇StdIO或SSE模式)

添加依賴庫

通過Poetry添加需要的Python庫

使用案例

數據分析演示AI可以逐步加載數據、執行分析和可視化結果

算法調試AI可以逐步測試算法並檢查中間變量

常見問題

為什麼推薦使用Docker?

如何添加新的Python庫?

StdIO和SSE模式有什麼區別?

🚀 筆記本執行 MCP 服務器

本項目用於在 MCP 服務器上執行筆記本的代碼運行。不過，目前該項目在其當前狀態下存在較大風險。

🚀 快速開始

本項目可讓您在 MCP 服務器上執行筆記本代碼，並且該 MCP 服務器允許您的大語言模型（LLM）進行逐步執行代碼，能以類似電子設計自動化（EDA）的方式更快地響應錯誤，變量會保留在內核中，可在以後的執行中使用。

✨ 主要特性

允許大語言模型（LLM）逐步執行代碼，並以類似 EDA 的方式更快地響應錯誤。
變量保留在內核中，可在後續執行中使用。

📦 安裝指南

嘿夥計，這不是一鍵運行命令就能完成的事情。為了保護您的系統免受 AI（這裡指克勞迪婭（Claude））的影響，最好在 Docker 環境中運行此服務器。所以請先安裝 Docker，然後再回來。

歡迎回來。這個鏡像目前不在 DockerHub 上，因此請運行以下命令：

git clone git@github.com:Neuron1c/mcp-notebooks.git
cd mcp-notebooks

docker build . -t mcp-notebooks:latest

已經完成了一半，請在 your claude_desktop_config.json 文件中添加以下內容：

標準輸入輸出（StdIO）

{
  "mcpServers": {
    "notebooks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp-notebooks:latest"
      ]
    }
  }
}

單獨運行（SSE）

或者手動運行：

docker run -p 3001:3001 mcp-notebooks:latest

現在配置 config.json 文件如下：

{
  "mcpServers": {
    "notebooks": {
      "command": "npx",
      "args": [
        "supergateway",
        "--sse",
        "http://localhost:3001/sse"
      ]
    }
  }
}