🚀 🪐 ✨ Jupyter MCP 服务器

Jupyter MCP 服务器是一个 Model Context Protocol (MCP) 服务器实现，它提供了与 📓 Jupyter 笔记本的交互功能，这些笔记本可在任何 JupyterLab（包括本地 JupyterLab）中运行，为用户带来便捷的操作体验。

🚀 快速开始

启动 JupyterLab

确保安装了以下软件包。协作包是必需的，因为得益于 Jupyter 实时协作，它可以在笔记本上显示所做的修改。

pip install jupyterlab jupyter-collaboration ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt

然后使用以下命令启动 JupyterLab：

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

你也可以运行 make jupyterlab。

⚠️ 重要提示

--ip 设置为 0.0.0.0 是为了使 MCP 服务器在 Docker 容器中运行时能够访问你的本地 JupyterLab。

与 Claude Desktop 结合使用

Claude Desktop 可以从 这个页面 下载，适用于 macOS 和 Windows。 对于 Linux，我们成功使用了基于 nix 的 UNOFFICIAL 构建脚本

# ⚠️ UNOFFICIAL
# 你也可以运行 `make claude-linux`
NIXPKGS_ALLOW_UNFREE=1 nix run github:k3d3/claude-desktop-linux-flake \
  --impure \
  --extra-experimental-features flakes \
  --extra-experimental-features nix-command

要与 Claude Desktop 结合使用，请在你的 claude_desktop_config.json 中添加以下内容（有关更多详细信息，请参阅 MCP 官方文档网站）。

⚠️ 重要提示

SERVER_URL 的值取决于你运行 JupyterLab 的位置。如果是在本地运行，应设置为 http://localhost:8888；如果是通过云服务器，则需要相应的 URL 和端口。

配置示例

对于 macOS 或 Windows：

cat $HOME/.config/Claude/desktop_config/claude_desktop_config.json

输出可能如下：

{
  "mcp_server": {
    "add_execute_code_cell": {
      "description": "添加并执行 Jupyter 笔记本中的代码单元格",
      "parameters": [
        {
          "name": "cell_content",
          "type": "string",
          "description": "要执行的代码"
        }
      ],
      "returns": "单元格输出"
    },
    "add_markdown_cell": {
      "description": "添加 Jupyter 笔记本中的 Markdown 单元格",
      "parameters": [
        {
          "name": "cell_content",
          "type": "string"
        }
      ]
    }
  }
}

📦 安装指南

安装必要软件包

pip install jupyterlab jupyter-collaboration ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt

启动 JupyterLab

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

或者运行 make jupyterlab。

💻 使用示例

基础用法

启动 JupyterLab 并与 Claude Desktop 结合使用的基本流程如下：

# 安装软件包
pip install jupyterlab jupyter-collaboration ipykernel
pip uninstall -y pycrdt datalayer_pycrdt
pip install datalayer_pycrdt

# 启动 JupyterLab
jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0

高级用法

在 Linux 系统上使用基于 nix 的 UNOFFICIAL 构建脚本与 Claude Desktop 结合使用：

# ⚠️ UNOFFICIAL
# 你也可以运行 `make claude-linux`
NIXPKGS_ALLOW_UNFREE=1 nix run github:k3d3/claude-desktop-linux-flake \
  --impure \
  --extra-experimental-features flakes \
  --extra-experimental-features nix-command