MCP Notebooks

🚀 筆記本執行 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"
      ]
    }
  }
}

添加 Python 庫

目前，項目的依賴項僅限於運行服務器所需的最小內容。要添加更多庫，請安裝 poetry（請使用 pipx 安裝以避免麻煩）

poetry add your-package

推薦添加的包：

• numpy
• pandas
• scikit-learn
• matplotlib
• seaborn

我發現 AI 真地會嘗試在展示內容時使用圖形庫。

📚 詳細文檔

待辦事項（TODO）

• 查看筆記本
• 更多沙盒化環境
• 設計數據導入方案（Kedro 目錄？）
• 依賴注入（或者讓用戶拉取和構建自己的容器）
• 切換到 uv