Jupyter_MCP_Server

Jupyter_MCP_Server

JupyterMCP - Jupyter Notebook Model Context Protocol 統合

JupyterMCP は、Model Context Protocol（MCP）を通じて Jupyter Notebook を Claude AI に接続し、Claude が Jupyter Notebook と直接やり取りして操作できるようにします。この統合により、AI を活用したコード実行、データ分析、可視化などが可能になります。

機能

• 双方向通信：WebSocket ベースのサーバーを通じて Claude AI を Jupyter Notebook に接続します
• セル操作：ノートブックのセルの挿入、実行、管理を行います
• ノートブック管理：ノートブックを保存し、ノートブックの情報を取得します
• セルの実行：特定のセルを実行するか、ノートブック内のすべてのセルを実行します
• 出力の取得：テキストの長さ制限オプションを使って、実行済みセルの出力内容を取得します

コンポーネント

システムは、次の 3 つの主要なコンポーネントで構成されています。

1. WebSocket サーバー（jupyter_ws_server.py）：Jupyter 内に WebSocket サーバーをセットアップし、ノートブックと外部クライアント間の通信を中継します
2. クライアント JavaScript（client.js）：ノートブック内で動作し、セルの挿入やコードの実行などの操作を処理します
3. MCP サーバー（jupyter_mcp_server.py）：Model Context Protocol を実装し、WebSocket サーバーに接続します

インストール

前提条件

• Python 3.12 以降（古いバージョンでも動作する可能性がありますが、テストされていません）
• uv パッケージマネージャー
• Claude AI デスクトップアプリケーション

uv のインストール

Mac の場合：

brew install uv

Windows（PowerShell）の場合：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

その他のプラットフォームについては、uv のインストールガイドを参照してください。

セットアップ

1. このリポジトリをコンピューターにクローンするか、ダウンロードします。

   git clone https://github.com/jjsantos01/jupyter-notebook-mcp.git
   

2. 必要なパッケージを含む仮想環境を作成し、jupyter-mcp カーネルをインストールします。これにより、Jupyter がインストール済みの場合に認識できるようになります。

   uv run python -m ipykernel install --name jupyter-mcp
   

3. （任意）分析に必要な追加の Python パッケージをインストールします。

   uv pip install seaborn
   

4. Claude デスクトップアプリとの統合を設定します。 Claude > Settings > Developer > Edit Config > claude_desktop_config.json を開き、次の内容を追加します。

      {
       "mcpServers": {
           "jupyter": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/src",
                   "run",
                   "jupyter_mcp_server.py"
               ]
           }
       }
   }
   

   /ABSOLUTE/PATH/TO/ を、お使いのシステム上の src フォルダーへの実際のパスに置き換えます。例：

   • Windows："C:\\Users\\MyUser\\GitHub\\jupyter-notebook-mcp\\src\\"
   • Mac：/Users/MyUser/GitHub/jupyter-notebook-mcp/src/

   以前に Claude を開いていた場合は、File > Exit を選択してから、もう一度起動してください。

使い方

接続の開始

1. Jupyter Notebook（バージョン 6.x）サーバーを起動します。

   uv run jupyter nbclassic
   

2. 新しい Jupyter Notebook を作成し、jupyter-mcp カーネルを選択します。kernel -> change kernel -> jupyter-mcp

3. ノートブックのセルで次のコードを実行し、WebSocket サーバーを初期化します。

   import sys
   sys.path.append('/path/to/jupyter-notebook-mcp/src')  # Add the path to where the scripts are located
   
   from jupyter_ws_server import setup_jupyter_mcp_integration
   
   # Start the WebSocket server inside Jupyter
   server, port = setup_jupyter_mcp_integration()
   

   '/path/to/jupyter-notebook-mcp/src' を、お使いのシステム上の src フォルダーに置き換えてください。例：

   • Windows："C:\\Users\\MyUser\\GitHub\\jupyter-notebook-mcp\\src\\"
   • Mac：/Users/MyUser/GitHub/jupyter-notebook-mcp/src/

   

4. MCP を有効にして Claude デスクトップアプリを起動します。

Claude での使用

接続すると、Claude は次のツールを利用できるようになります。

• ping - サーバーへの接続を確認します
• insert_and_execute_cell - 指定した位置にセルを挿入して実行します
• save_notebook - 現在の Jupyter ノートブックを保存します
• get_cells_info - ノートブック内のすべてのセルの情報を取得します
• get_notebook_info - 現在のノートブックの情報を取得します
• run_cell - インデックスを指定してセルを実行します
• run_all_cells - ノートブック内のすべてのセルを実行します
• get_cell_text_output - 指定したセルの出力内容を取得します
• get_image_output - 指定したセルの画像出力を取得します
• edit_cell_content - 既存のセルの内容を編集します
• set_slideshow_type- セルのスライドショーの種類を設定します