Jupyter Notebook MCP

🚀 使用説明

このドキュメントは、システムのインストール、Claude Desktopの使用、外部クライアントによるテスト、問題解決などの手順を説明します。

🚀 クイックスタート

📦 インストール

インストール依存関係

以下のソフトウェアがインストールされていることを確認してください。

• Python 3.x
• pip（Pythonパッケージを管理するため）
• uvicorn（WebSocketサーバーを起動するため）

これらの依存関係をインストールするには、ターミナルまたはコマンドプロンプトで以下のコマンドを実行します。

pip install uvicorn websockets jupyter-client python-dotenv

Jupyter Notebookの起動

ターミナルまたはコマンドプロンプトで以下のコマンドを実行して、Jupyter Notebookを起動します。

jupyter notebook

WebSocketサーバーの起動

プロジェクトディレクトリに移動してから、以下のコマンドを実行してWebSocketサーバーを起動します。

uvicorn server:app --reload

これにより、http://localhost:8000にローカルサーバーが起動します。

💻 使用例

Claude Desktopの使用

ダウンロードとインストール

公式リンクにアクセスして、Claude Desktopをダウンロードしてインストールします。

Claude Desktopの設定

Claude Desktopを開き、設定メニューに移動します。

1. API Settingsを見つけます。
2. APIキーがある場合は、それを入力します。
3. 保存をクリックします。

Jupyter Notebookの接続

Claude Desktopで、File > Openを選択し、Jupyter Notebookファイルを選択します。

外部クライアントによるテスト

外部クライアントの起動

以下のコマンドを実行して外部クライアントを起動します。

uv run python src/jupyter_ws_external_client.py

バッチモード

バッチモードで実行する場合は、以下のコマンドを使用します。

uv run python src/jupyter_ws_external_client.py --batch

🔧 問題解決

接続問題

接続がタイムアウトした場合は、以下の手順を試してみてください。

• WebSocketサーバーを再起動します。
• ポートの競合を確認します：デフォルトのポートは8765です。このポートが使用中の場合、サーバーは自動的に別の利用可能なポートを選択します。

セル実行問題

セルの内容が有効で、カーネルが実行中であることを確認してください。これは以下の方法で確認できます。

1. Jupyter NotebookのKernelメニューをクリックします。
2. 選択したカーネルが起動していることを確認します。

WebSocketポートの競合

デフォルトのポート8765が使用中の場合、サーバーは自動的に別の利用可能なポートを試みます。

📚 制限事項と注意事項

⚠️ 重要提示

• Jupyter Notebook 6.xバージョンのみがサポートされています。
• テキスト出力は1500文字に制限されています。
• 高度なJupyterプラグインの相互作用（カスタムウィジェットなど）はサポートされていません。
• 接続は長時間のアイドル状態でタイムアウトする場合があります。

📄 その他のリソース

このプロジェクトは以下のプロジェクトに触発されています。

• ihrpr
• Datalayer