Datalayer Jupyter MCP Server

🚀 🪐 ✨ Jupyter MCP サーバー

この Jupyter MCP サーバーは、JupyterLab を用いたノートブックの操作を強化し、Claude Desktop との連携を可能にするサーバーです。Jupyter のリアルタイムコラボレーション機能を活用し、効率的な作業をサポートします。

🚀 クイックスタート

JupyterLab の起動

以下のコンテンツがインストールされていることを確認してください。ノートブックへの変更は Jupyter リアルタイムコラボレーション（RTC）を通じて確認できます。

pip install jupyterlab jupyter-collaboration ipykernel

次に、以下のコマンドを使用して JupyterLab を起動します。

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

⚠️ 重要提示

--ip を 0.0.0.0 に設定することで、Docker コンテナ内で実行される MCP サーバーからローカルの JupyterLab にアクセスできるようになります。

Claude Desktop との連携

Claude Desktop と連携するには、以下の内容を claude_desktop_config.json に追加してください。

⚠️ 重要提示

SERVER_URL と TOKEN のポートが jupyter lab コマンドで使用されているものと一致することを確認してください。NOTEBOOK_PATH は JupyterLab の起動ディレクトリを基準としたパスにする必要があります。

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"
      }
    }
  }
}

✨ 主な機能

コンポーネント - ツール

現在のサーバーは以下の 2 つのツールを提供しています。

📦 インストール

ビルド

以下のコマンドを使用して Docker イメージをビルドします。

docker build -t datalayer/jupyter-mcp-server .

Smithery を通じたインストール

Smithery を通じて Claude Desktop 用の Jupyter MCP サーバーを自動インストールするには、以下のコマンドを実行します。

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