Jupyter MCP Server for Claude Desktop

面向 Claude Desktop 的 Jupyter MCP 服务

Model Context Protocol (MCP) 服务的实现，可与任何 JupyterLab 环境（包括本地实例）中运行的 Jupyter 笔记本交互。旨在与 macOS、Windows 和 Linux 上的 Claude Desktop 无缝集成。

---

🚀 功能

• 为 Jupyter 笔记本提供 MCP 服务接口。
• 支持通过 JupyterLab 实时协作。
• 与 Claude Desktop（macOS、Windows、Linux）顺畅集成。
• 以编程方式在笔记本中添加并执行代码单元格或 Markdown 单元格。

---

📦 开始使用

✅ 前置条件

确保已安装以下内容：

• JupyterLab（版本 4.4.1）
• jupyter-collaboration（版本 4.0.2）
• ipykernel
• datalayer_pycrdt（版本 0.12.15）

🛠 安装

pip install jupyterlab==4.4.1 jupyter-collaboration==4.0.2 ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt==0.12.15

---

▶️ 启动 JupyterLab

jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0

或者，也可以使用：

make jupyterlab

--ip 0.0.0.0 允许从运行在 Docker 内的 MCP 服务访问。

---

💻 与 Claude Desktop 集成

Claude Desktop 可用于 macOS 和 Windows。Linux 用户可以通过 Nix 使用非官方构建脚本。

🔧 配置（macOS / Windows）

{
  "mcpServers": {
    "jupyter": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH",
        "datalayer/jupyter-mcp-server:latest"
      ],
      "env": {
        "SERVER_URL": "http://host.docker.internal:8888",
        "TOKEN": "MY_TOKEN",
        "NOTEBOOK_PATH": "notebook.ipynb"
      }
    }
  }
}

🔧 配置（Linux）

{
  "mcpServers": {
    "jupyter": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "SERVER_URL", "-e", "TOKEN", "-e", "NOTEBOOK_PATH", "--network=host",
        "datalayer/jupyter-mcp-server:latest"
      ],
      "env": {
        "SERVER_URL": "http://localhost:8888",
        "TOKEN": "MY_TOKEN",
        "NOTEBOOK_PATH": "notebook.ipynb"
      }
    }
  }
}

确保 SERVER_URL 和 TOKEN 与 JupyterLab 设置一致。NOTEBOOK_PATH 是相对于 JupyterLab 启动目录的路径。

---

🛠 可用工具

工具	描述	输入参数	输出
add_execute_code_cell	在笔记本中添加并执行代码单元格	cell_content (str)	单元格输出
add_markdown_cell	在笔记本中添加 Markdown 单元格	cell_content (str)	成功消息

---

🐳 构建 Docker 镜像

make build-docker

---

📦 通过 Smithery 安装

npx -y @smithery/cli install @datalayer/jupyter-mcp-server --client claude

---

📄 许可证

许可证详情请参阅代码仓库。

---

🔗 资源

• 官方代码仓库： datalayer/jupyter-mcp-server
• MCP 协议文档： modelcontextprotocol.io