Jupyter MCP Server Kshitij

🚀 Jupyter MCP サーバークライアント

このリポジトリには、多協調プロトコルをサポートする Jupyter サーバーに接続するための Docker ベースのクライアントが含まれています。Claude デスクトップ環境で Windows と Mac で使用するのに適しています。

🚀 クイックスタート

このセクションでは、Jupyter MCP サーバークライアントをセットアップし、使用するための手順を説明します。

📦 インストール

前提条件

• Python 3.12.10
• Docker
• Git

1. Python 環境の設定

# 仮想環境の作成とアクティブ化
python3.12 -m venv env
source env/bin/activate  # Windows: env\Scripts\activate

# パッケージマネージャーのインストール
pip install uv

# 必要なパッケージのインストール
uv pip install jupyterlab jupyter-collaboration ipykernel pycrdt
uv pip install jupyter-nbmodel-client jupyter_kernel_client

# 依存関係の修正（互換性要件）
pip uninstall -y jupyter_server_ydoc pycrdt
uv pip install jupyter_server_ydoc pycrdt

2. ノートブックの作成

# リポジトリのクローン -> この手順は必須です
git clone https://github.com/kshitijdesai99/jupyter_mcp_server_kshitij.git
cd jupyter_mcp_server_kshitij
touch notebook.ipynb

3. Jupyter サーバーの起動

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

⚠️ 重要な注意

MY_TOKEN を好みの認証トークンに置き換えるか、そのままにしておきます。

4. tornado.websocket.WebSocketClosedError エラーが発生した場合（Mac 用）

• notebook.ipynb ファイルを削除します。
• Jupyter サーバーで新しいノートブックを作成し、notebook.ipynb という名前に変更します。

Docker コマンド

Docker イメージのビルド

docker build -t notebook-client .

クライアントコンテナの実行 --> テスト用のみ、MCP には不要

docker run \
  -e NOTEBOOK_PATH="notebook.ipynb" \
  -e SERVER_URL="http://host.docker.internal:8888" \
  -e TOKEN="MY_TOKEN" \
  notebook-client

⚠️ 重要な注意

異なるディレクトリから実行する場合は、ノートブックファイルへの完全パスを使用してください。

Claude デスクトップ統合

この設定を Claude デスクトップの config.json ファイルに追加します。

"jupyter": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-e", "NOTEBOOK_PATH=notebook.ipynb",
      "-e", "SERVER_URL=http://host.docker.internal:8888",
      "-e", "TOKEN=MY_TOKEN",
      "notebook-client"
    ]
}

⚠️ 重要

ノートブックパスを更新する必要はありません。

トラブルシューティング

• クライアントを接続する前に、Jupyter サーバーが実行中であることを確認してください。
• サーバーとクライアントの設定でトークンが一致していることを確認してください。
• Windows のパスを Docker で使用する場合は、例のようにダブルバックスラッシュを使用してください。