MCP Server Jupyter

🚀 mcp-server-jupyter 服務器

mcp-server-jupyter 是一個 MCP 服務器，可用於管理和交互式操作 Jupyter 筆記本，實現對筆記本的程序化管理。

🚀 快速開始

與 Claude Desktop 配合使用

第一步：啟動 JupyterLab 或 Jupyter Notebook

為了方便管理虛擬環境和軟件包安裝，建議使用 uv 來運行 Jupyter 筆記本。 參考 uv 的 Jupyter 文檔 瞭解更多細節：

uv venv --seed
source .venv/bin/activate
uv pip install jupyterlab
.venv/bin/jupyter lab

注意：此環境應作為 UV_PROJECT_ENVIRONMENT 環境變量在 MCP 服務器中使用（下一步）。確保在同一目錄下運行。

echo $(pwd)/.venv

第二步：配置 Claude Desktop

將以下配置添加到你的 Claude Desktop 配置文件： PyPi 包安裝方式：

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "Jupyter-notebook-manager": {
      "command": "uv",
      "args": ["run", "--with", "mcp-server-jupyter", "mcp-server-jupyter"],
      "env": {
        "UV_PROJECT_ENVIRONMENT": "/path/to/venv_for_jupyter/.venv"
      }
    }
  }
}

Git 倉庫克隆方式：

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "Jupyter-notebook-manager": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/inna/mcp-server-jupyter/src/mcp_server_jupyter",
        "mcp-server-jupyter"
      ],
      "env": {
        "UV_PROJECT_ENVIRONMENT": "/path/to/venv_for_jupyter/.venv"
      }
    }
  }
}

第三步：使用說明

• 啟動 JupyterLab 或 Jupyter Notebook 實例。
• 配置 MCP 服務器時，確保設置正確的 UV_PROJECT_ENVIRONMENT 環境變量。
• 在你的項目目錄中添加相關依賴項：

uv pip install mcp-server-jupyter

✨ 主要特性

該服務器提供了六種工具用於筆記本的操作：

1. 讀取包含輸出的筆記本內容：讀取筆記本內容，包括單元格輸出。
   • 必填參數：notebook_path（字符串）
2. 僅讀取源代碼的筆記本內容：不包含輸出地讀取筆記本內容。
   • 適用於因大小限制無法讀取完整筆記本的情況。
   • 必填參數：notebook_path（字符串）
3. 讀取特定單元格的輸出：獲取指定單元格的輸出內容。
   • 必填參數：
     • notebook_path（字符串）
     • cell_id（字符串）
4. 添加新單元格：在筆記本中添加新的單元格。
   • 必填參數：
     • notebook_path（字符串）
     • source（字符串）
   • 可選參數：
     • cell_type（字符串）："code" 或 "markdown"
     • position（整數）：插入位置（-1 表示追加）
5. 編輯單元格內容：修改指定單元格的內容。
   • 必填參數：
     • notebook_path（字符串）
     • cell_id（字符串）：唯一標識符
     • source（字符串）
6. 執行特定單元格：執行指定單元格並返回輸出結果。
   • 適用於驗證單元格的執行和輸出。
   • 必填參數：
     • notebook_path（字符串）
     • cell_id（字符串）

📄 許可證

該項目採用 MIT License，具體信息請參見 LICENSE 文件。

⚠️ 重要提示

• 修改筆記本後，請重新加載頁面以應用更改。
• 確保 Jupyter 實例保持運行狀態，以便繼續使用 MCP 服務器。