Jupyter MCP Server

🚀 🪐 ✨ Jupyter MCP サーバー

Jupyter MCP サーバーは、Model Context Protocol (MCP) サーバーの実装です。これにより、任意の JupyterLab（ローカルの JupyterLab も含む）で実行される 📓 Jupyter ノートブックとのインタラクションが可能になります。

🚀 クイックスタート

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 ベースの 非公式ビルドスクリプト を使用して成功しています。

# ⚠️ 非公式
# `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",
          "description": "Markdown セルの内容"
        }
      ]
    }
  }
}